极限 编程 的 创始 人 Kent Beck 对 编程 给 出 了 如 下 定义 : 
1) 编程 是 一 种 态度 。 
2) 编程 是 一 种 技艺 。 


3) 编程 是 一 种 习惯 。 


这 三 句 话 的 语序 并 非 随意 排列 ， 而 是 代表 了 一 个 渐进 的 过 程 。 首 先 需要 树立 正确 的 编程 态度 ， 进 而 追求 编程 技艺 的 提升 ， 最 终 形成 良好 的 编程 习惯 。 


正 所 谓 “ 态 度 决定 一 切 ”， 编 程 态度 的 重要 性 不 言 而 喻 ， 殊 不 知 ， 作 为 程序 员 的 我 们 却 常常 忽略 了 它 。 不 是 轻视 ， 而 是 自 以 为 已 经 理解 。 写 出 好 代码 ， 不 是 自然 而 然 的 吗 ? 哪里 用 得 着 再 三 强调 ? 


只 是 他 们 会 说 : “倘若 时 间 人 允许 ,我 当然 是 要 竭尽 所 能 写 出 好 代码 啊 ! ” 


言 外 之 意 ， 若 是 时 间 不 允许 ， 我 们 就 有 了 粗 制 渴 造 的 权利 了 ! 


倘若 不 是 编码 ， 而 是 修建 一 栋 大 厦 ， 难 道 建筑 工人 可 以 说 : “倘若 时 间 人 允许 ， 我 当然 要 建造 出 牢固 抗震 的 大 厦 啊 !“ 


言 外 之 意 ， 若 是 时 间 不 允许 ， 我 们 就 可 以 放宽 大 厦 的 质量 了 ! 


时 间 ， 何 其 无 率 ! 


真正 的 编码 态度 ， 就 是 要 在 任何 时 刻 都 要 保持 精益 求 精 ， 务 求 代码 的 正确 无 误 ， 务 求 代码 的 清晰 可 读 。 一 旦 嗅 到 代码 的 “ 坏 味道 ”， 我 们 就 应 该 及 时 重 构 。 对 于 烂 代码 ， 我 们 就 应 该 尽力 去 驯服 ! BHA 
为 ， 这 或 许 才 是 伍 斌 写作 本 书 的 初衷 : 贯 以 正确 的 编程 态度 ， 进 而 提升 编码 技艺 。 


软件 架构 的 重要 性 不 言 自明 ， 开 发 团队 也 舍得 花 大 量 的 成 本 在 架构 上 追求 最 好 。 对 于 如 何 编写 出 好 的 代码 ， 虽 有 诸如 Martin Fowler, Robert C.Martin、Michael C.Feathers 等 大 师 珠玉 在 前 ， 为 我 们 
编写 出 好 代码 提供 了 良好 的 模板 ， 但 是 现状 却 是 大 量 的 烂 代码 俯 拾 皆 是 ， 而 且 层出不穷 ， 并 随 着 项 目的 演进 而 蔓延 ， 以 至 于 酿 成 不 可 挽回 之 势 。 究 其 原因 ， 还 是 在 一 开始 就 没有 对 烂 代码 给 予 足 够 的 重视 ， 
为 了 赶 进度 ， 我 们 只 追求 功能 的 实现 ， 满 足 一 时 之 需求 。 我 们 忘记 了 地 面 的 坎坷 ， 忘 记 了 沼泽 的 泥 河 ， 刻 意 编织 了 一 个 美好 的 幻梦 ， 致 使 我 们 忘记 当下 ， 只 顾 着 远 望 前 方 ， 以 至 于 越 陷 越 深 而 不 自觉 。 当 我 
们 泥 足 深 陷 而 不 可 自拔 时 ， 才 发 现 这 些 烂 代码 已 经 不 是 我 们 目前 的 能 力 所 能 够 应 对 的 了 。 悔 之 晚 侨 ! 


态度 是 第 一 位 的 。 如 果 我 们 从 一 开始 就 学 会 小 步 前 行 ， 并 保证 步伐 的 稳健 ， 即 使 路 况 堪忧 ， 也 未 必 会 泥 足 深 陷 。 若 是 必须 在 泥沼 之 上 行走 ， 我 们 也 可 以 找 来 木板 竹 排 ， 减 轻 身 陷 其 中 的 压力 。 对 于 程序 
员 来 说 ， 驯 服 烂 代码 ， 其 实 就 是 我 们 谋生 的 技能 ， 就 是 行走 泥沼 必 备 的 木板 竹 排 。 因 此 ， 操 练 编码 能 力 ， 提 升 自 己 的 谋生 技能 ， 不 过 是 题 中 应 有 之 义 。 既 然 应 丁 可 以 将 解 牛 作成 一 门 艺术 ， 我 们 自然 也 不 能 
为 写 出 勉强 可 用 的 代码 而 自满 自足 。 


伍 斌 的 这 本 大 作 得 自 他 自己 年 复 一 年 对 代码 的 操练 ， 真 正体 会 了 “练习 中 的 平凡 与 伟大 ” ， 从 而 将 测试 驱动 开发 、 重 构 与 设计 模式 应 用 娴熟 ， 达 到 得 心 应 手 的 程度 。 本 书 就 是 伍 斌 日 常 的 训练 宝典 ， 实 
战 笔录 。 作 为 编程 操练 社区 bjdp.org[1] 的 创始 人 ， 伍 斌 几乎 将 全 部 身心 都 投入 到 IT 社区 公益 中 ， 为 程序 员 提 升 编码 技能 布道 传 法 ， 孜 孜 不 倦 ， 这 令 我 钦佩 不 已 。 如 今 大 作 得 以 付 梓 出 版 ， 也 算是 IT 社区 的 幸 
事 。 毕 竟 编 程 操 练 社区 园 于 场地 与 人 力 的 限制 ， 无 法 普及 到 更 多 的 程序 员 。 因 而 ， 阅 读本 书 的 读者 ， 完 全 可 以 照 着 书 中 的 例子 ， 来 一 次 虚拟 的 编程 道场 ， 操 练 技艺 ， 驯 服 烂 代码 ， 不 亦 乐平 。 


陆 放 翁 诗 云 “ 纸 上 得 来 终 觉 浅 ， 绝 知 此 事 要 躬 行 ”， 这 正 是 阅读 本 书 的 正确 做 法 。 虚 拟 编程 道场 ， 等 你 来 间 ! 


一 一 张 选 
Lead Consultant, ThoughtWorks 


[由 bjdp.org 北 京 设计 模式 学 习 组 (Beijing Design Patterns Study Group) 是 笔者 在 2013 年 4 月 6 日 创办 的 公益 编程 操练 社区 ， 参 见 网 站 http://www.bjdp.org。 


程序 员 好 比 运动 员 ， 要 想 在 竞技 场 上 获胜 ， 需 要 在 训练 场 里 长 期 刻苦 地 练习 技艺 。 


程序 员 好 比 士兵 ， 要 想 在 短兵相接 的 白 丸 战 中 取胜 ， 需 要 在 练兵 场 上 长 期 刻苦 地 练习 格斗 。 


程序 员 好 比 调 酒 师 ， 要 想 用 炫目 的 技艺 为 客人 花 式 调 酒 []]， 需 要 在 业余 时 间 长 期 练习 抛 瓶 。 


运动 员 与 和 平年 代 的 士兵 有 大 量 的 时 间 用 于 训练 。 但 绝 大 多 数 程序 员 所 在 的 软件 公司 ， 在 一 个 接着 一 个 的 项 目 进 度 的 压力 下 ， 无 法 提供 大 量 的 时 间 来 供 程序 员 练习 ， 而 很 多 程序 员 又 不 愿意 在 下 班 后 再 
碰 代 码 。 如 此 一 来 ， 程 序 员 们 就 成 了 一 直 在 竞技 场 上 比赛 的 运动 员 ， 一 直 在 敌人 面前 搏斗 的 士兵 ， 和 一 直 在 客人 面前 抛 瓶 的 调 酒 师 ， 他 们 没有 时 间 练 习 。 


这 样 不 做 练习 的 程序 员 ， 只 能 把 在 练习 过 程 中 所 犯 的 错误 都 留 在 了 公司 的 代码 库 里 ， 成 为 了 烂 代码 。 已 有 的 烂 代 码 延长 了 给 软件 添加 新 功能 和 修复 bug 的 时 间 ， 带 来 更 大 的 进度 压力 ， 这 就 导致 利用 工 
作 时 间 练 习 的 机 会 更 少 了 ， 进 而 在 代码 库 里 留 下 更 多 的 练习 时 所 犯 的 错误 ， 形 成 了 更 多 的 烂 代码 。 如 此 往复 ， 万 动 不 复 。 


如 此 说 来 ， 程 序 员 应 该 像 调 酒 师 那 样 ， 上 班 时 间 努 力 工作 ， 下 班 时 间 操练 手艺 。 


编程 是 一 门 手 艺 。 手 艺 是 自己 的 ， 如 果 在 公司 领导 的 支持 下 能 在 上 班 时 练习 固然 很 好 ， 但 若 条 件 不 具备 ， 那 么 就 在 下 班 时 自己 练 。 其 实 这 也 不 吃亏 ， 艺 多 不 压 身 。 


本 书 就 是 为 程序 员 练 习 编程 这 门 手艺 而 撰写 的 。 


这 是 一 本 什么 样 的 书 ? 


这 是 一 本 讨论 如 何 用 TDD (测试 驱动 开发 ) 方法 驯服 烂 代码 的 书 。 无 论 程序 员 水 平 是 高 是 低 ， 都 可 能 写 出 烂 代码 。 所 以 驯服 烂 代码 是 每 一 位 程序 员 都 会 面临 的 工作 。 而 如 何 驯服 则 需要 亲手 重 构 代码 并 
加 以 体会 才能 得 心 应 手 。 本 书 就 是 笔者 在 最 近 这 一 年 半 的 时 间 里 ， 在 自己 所 创办 的 公益 编程 操练 社区 bjdp.org 进 行 编程 操练 获得 的 体会 的 结晶 。 


这 是 一 本 描写 编程 过 程 的 书 。“ 授 人 以 鱼 ， 不 如 授 之 以 渔 。” 这 里 ，“ 鱼 ”是 结果 ， 而 “ 渔 ” 是 过 程 。 如 此 说 来 ， 过 程 要 比 结果 重要 。 同 样 ， 获 得 一 段 重 构 好 的 整洁 的 代码 固然 很 好 ， 但 是 不 如 掌握 从 
最 初 的 烂 代码 转变 到 最 终 的 整洁 代码 的 整个 过 程 的 重 构 方法 。 


这 是 一 本 以 结对 编程 的 对 话 形式 来 展示 编程 过 程 的 书 。 自 古 以 来 ， 作 为 一 心 学 艺 的 弟子 ， 无 不 渴望 师父 能 一 对 一 地 向 自己 传授 绝技 。 就 好 比 《西游 记 》 中 的 猴 王 ， 拜 到 车 提 祖 师 门下 为 徒 ， 直 到 7 年 之 
后 ， 才 有 缘 深 夜 得 到 师父 一 对 一 的 传授 ， 最 终 获得 真传 。 而 与 此 类 似 ， 结 对 编程 就 是 两 人 之 间 一 对 一 进行 知识 传递 的 过 程 ， 机 会 难得 ， 每 时 每 刻 都 弥 足 珍贵 。 


这 本 书 能 带 来 什么 价值 ? 


本 书 最 大 的 价值 ， 就 是 能 让 人 在 动手 驯服 烂 代 码 的 过 程 中 真正 体会 到 为 什么 TDD 方 法 能 让 开发 速度 加 快 。 具 体 来 说 理由 有 如 下 3 个 。 


1) 专注 。 即 在 开发 中 只 专注 于 编写 恰好 能 让 描述 产品 特性 的 测试 代码 运行 通过 的 生产 代码 ， 而 不 再 多 写 除 此 之 外 的 其 他 代码 。 用 TDD 的 测试 先行 进行 开发 ， 就 和 男人 逛 超市 一 样 ， 他 们 会 按照 纸 片上 的 
购买 清单 (好 比照 着 测试 代码 ) 拿 货 、 掏 钱 、 走 人 ， 精 益 适 用 ， 不 做 无 用 功 。 而 用 不 用 TDD 的 测试 后 行进 行 开发 ， 就 好 比 女人 和 逛 超市 ， 看 到 有 什么 打折 的 、 新 款 的 、 促 销 的 好 东西 都 想 买 (好 比 程序 员 编写 
了 很 多 当下 用 不 到 的 生产 代码 ) ， 从 而 造成 浪费 。 


2) 复 用 。 在 TDD 开 发 中 编写 的 自动 化 测试 代码 ， 将 来 可 以 复 用 ， 能 节省 以 后 debug 和 看 log 的 时 间 ; 不 写 测试 而 依赖 手工 debug 或 看 log 的 做 法 ， 将 来 无 法 复 用 ， 每 次 都 会 做 很 多 诸如 设置 断 点 、 单 步 
运行 、 检 查 变量 、 打 开 并 阅读 日 志文 件 等 重复 性 工作 ， 从 而 浪费 大 量 时间 。 


Si 


3) 反馈 早 。 如 果 程 序 员 能 够 频繁 运行 TDD 中 的 测试 ， 那 么 就 能 使 软件 的 绝 大 多 数 bug 在 流入 下 游 测试 工程 师 之 前 被 快速 发 现 和 修复 。 这 种 反馈 会 远 远 早 于 那 种 软件 只 由 测试 工程 师 来 测试 的 情况 ， 从 而 
能 节省 下 面 这 些 人 员 可 观 的 工作 时 间 : 测试 工程 师 发 现 、 描 述 、 报 告 和 跟踪 bug; 项 目 经 理 在 各 种 会 议 中 检查 、 梳 理 和 分 派 这 些 bug; 程序 员 放 下 手中 工作 来 阅读 测试 工程 师 报告 的 pug 并 加 以 重 现 和 修复 。 
些 人 员 就 能 利用 所 节省 的 时 间 来 干 更 有 价值 的 事情 ， 以 加 快 项 目 进度 。 


适合 读 这 本 书 吗 ? 


本 书 适 合 愿意 动手 党 试用 测试 先行 的 TDD 开 发 方法 进行 编程 操练 以 提高 编程 技艺 的 任何 人 ， 包 括 专业 的 程序 员 、 自 动 化 测试 工程 师 、 架 构 师 、 开 发 经 理 及 任何 TDD 开 发 方法 的 学 习 者 ， 只 要 您 具备 下 面 


的 一 些 经 验 : 


“能够 编写 、 编 译 并 运行 一 段 简单 的 Java 程 序 ; 


"了解 或 能 查询 到 面向 对 象 的 三 个 基本 特征 的 概念 一 一 封装 、 继 承 和 多 态 ; 


"了解 或 能 查询 到 有 关 设计 模式 和 重 构 的 信息 。 


这 本 书 讲 了 什么 内 容 ? 


本 书 可 分 为 四 大 部 分 。 


第 一 部 分 (第 1~10 章 ) 阐释 了 烂 代码 的 概念 。 其 中 第 1~4 章 用 测试 后 行 的 开发 方法 完成 了 一 个 编程 题目 ， 第 5~8 章 用 测试 先行 的 开发 方法 完成 了 上 面 同 样 的 编程 题目 。 在 第 9 章 对 比 了 测试 后 行 与 测试 
先行 的 开发 方法 后 ， 引 出 了 第 10 章 有 关 何 谓 烂 代码 的 讨论 ， 从 而 令 人 能 够 看 出 上 面 两 种 开发 方法 中 究竟 哪 一 种 更 不 容易 写 出 烂 代码 。 


第 二 部 分 (第 11~15 章 ) 详 述 了 驯服 一 段 烂 代码 的 过 程 。 其 中 第 11 章 阅读 了 一 段 烂 代码 ， 并 把 阅读 中 所 闻 到 的 代码 腐 自 味 用 TODO 记 录 下 来 。 第 12 章 编写 了 3 个 “用 户 意图 测试 ”来 固化 代码 现 有 的 行 
为 ， 并 将 这 些 测试 运行 通过 ， 为 下 一 步 重 构 做 好 准备 。 第 13 章 和 第 14 章 分 别 用 金 底 抽 薪 和 抛砖引玉 的 手法 来 将 一 个 大 类 分 解 为 若干 个 小 类 ， 即 进行 重 构 。 第 15 章 继续 重 构 来 清除 分 解 大 类 工作 完成 后 所 遗留 
下 来 的 代码 腐 臭 。 


第 三 部 分 (第 16~18 章 ) 详 述 了 编写 真正 的 单元 测试 的 过 程 。 其 中 第 16 章 用 提取 接口 的 办 法 编写 Stub 来 进行 单元 测试 ， 第 17 章 用 子 类 化 并 覆 写 方法 的 办 法 编写 Mock 来 进行 单元 测试 ， 第 18 章 将 被 测 类 
与 文件 系统 之 间 的 这 种 不 适合 用 于 单元 测试 的 耦合 ， 转 化 为 被 测 类 与 字符 串 之 间 这 种 适合 用 于 单元 测试 的 耦合 ， 从 而 通过 编程 操练 体会 什么 是 真正 的 单元 测试 。 


第 四 部 分 (第 19~20 章 ) 总 结 了 驯服 烂 代码 的 步骤 及 方法 。 其 中 第 19 章 提出 了 本 书 有 关 TDD 开 发 方法 的 一 种 实现 一 一 lePpTr 方 法 ， 该 方法 提出 了 全 面 重 构 的 概念 ， 对 传统 的 重 构 概念 进行 了 扩展 。 第 20 
章 讨论 了 如 何 才 能 使 前 面 所 讨论 的 良好 的 编程 方法 形成 习惯 并 固化 下 来 。 最 后 附录 A 介 绍 了 有 关 编 程 操 练 的 内 容 ， 附 录 B 至 附录 D 分 别 说 明了 如 何在 Windows、OS X 和 Linux 上 搭建 编程 操练 环境 。 


{1] 调 酒 一 般 分 为 英 式 和 花 式 〈 美 式 ) 两 种 风格 。 前 者 是 很 正统 的 调 酒 方式 ， 没 有 任何 花哨 的 成 分 在 里 面 。 而 后 者 类 似 于 杂技 一 样 ， 以 炫目 的 动作 去 吸引 人 的 眼光 。 参 见 : http://zhidao.baidu.com/link? 


url=wodhMvyJas K8t0j1 LrQf{NuJ4IX37R68EVDUWFGdmwRW14zXMbLAN4wxck NOCqCqlKRpUrVOsow9SrynDjbQ8Va。 
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“什么 是 软件 ?“ 
机 的 我 来 说 ， 软 件 就 是 学 校 计算 机 房 
档 。” 老 师 对 软件 的 定义 ， 深 深 地 刻 


这 一 点 在 我 大 学 毕业 后 20 年 的 软件 开发 相关 工作 的 实践 中 ， 不 断 地 得 到 印证 。 各 种 各 样 的 文档 一 一 需求 文档 、 概 要 设计 文档 、 详 细 设 计 文档 、 测 试 文档 等 ， 在 我 先后 经 历 的 多 个 软件 开发 项 


20 世 纪 90 年 代 初 的 一 个 冬 


第 1 


里 那些 DEC 小 型 机 
在 我 的 脑子 里 ， 其 程度 之 深 ， 以 至 于 在 之 


占据 着 重要 的 地 位 。 只 


“毕竟 ， 


理 眼 中 ， 摆 写 文档 和 编写 注释 的 能 力 ， 是 衡量 程序 员 是 否 称职 的 一 项 重要 标准 。 


“为 保证 客观 性 ， 软 件 开发 完成 


= 


草 


后 ， 应 该 由 不 同 的 人 员 来 对 其 进行 测试 。” 老 师 的 这 句 话 也 时 时 莹 绕 在 我 的 


刻 舟 求 剑 的 文档 


在 10 多 年 中 ， 我 经 历 的 每 一 个 项 目 ， 都 无 一 例外 地 有 一 个 独立 于 开发 团 


致 认为 测试 就 是 测试 工程 师 的 事情 。 


给 测试 团队 去 测试 了 。 


十 几 年 来 ， 不 管 是 开发 新 功能 还 是 修复 bug， 我 一 直 在 努力 地 撰写 文档 ， 编 写 和 修改 代码 及 注释 ， 然 后 交 给 测试 人 员 去 测试 ,， 


完美 和 正确 。 但 是 最 后 我 却 难过 地 发 现 ， 
法 或 许 会 助长 烂 代码 的 滋生 。 这 些 文档 就 好 像 “ 刻 舟 求 剑 ” 故 事 中 那个 刻 在 船 身上 的 记 


这 种 方法 开发 出 来 的 软件 ， 无 一 例外 逐渐 沦 为 烂 代码 。 在 


AO, ABATE 


， 在 北京 东南 部 的 一 所 大 学 里 ， 一 位 年 近 花 甲 的 老师 ， 给 我 们 这 些 计算 机 系 的 学 生 讲 软件 工程 这 门 课时 ， 问 了 这 个 问题 。 对 于 当时 几乎 没有 机 会 接触 计算 
上 令 人 费解 的 命令 ， 和 286 个 人 计算 机 里 那些 好 玩 的 “ 吃 豆子 ”和 “赛车 ”游戏 。 
后 的 很 长 一 段 时 间 里 ， 总 令 我 觉得 文档 对 于 软件 的 影响 力 ， 似 乎 要 超过 程序 。 


“软件 不 仅仅 是 程序 ， 还 包括 描述 程序 的 文档 。 软 件 就 是 程序 加 文 


中 ,始终 


文档 在 ， 就 不 怕 开 发 人 员 的 频繁 更 换 。” 一 位 软件 开发 经 理 这 样 对 我 说 。 除 了 要 写 Word 或 Excel 的 文档 ， 程 序 员 们 还 被 要 求 在 源 代码 中 写 尽量 详 尽 的 注释 。 在 软件 开发 经 


队 的 测试 团 


队 ， 开 发 团 


队 将 代码 开发 完成 后 ， 简 单 地 在 


。 让 我 们 先 


对 于 本 书 中 所 有 的 编程 操练 ， 我 都 将 邀请 您 一 一 我 的 亲爱 的 读者 一 一 来 与 我 一 起 结对 编程 。 


“ 啊 ? 和 我 结对 编程 ? 我 还 从 来 没 试 过 哩 ! ”读者 可 能 会 说 1 


这 种 传统 的 测试 后 行 [ (test last) 的 


向 力 是 如 此 巨大 ， 以 至 于 前 些 年 我 做 程序 员 时 ， 我 和 周转 
自己 机 器 上 运行 一 下 ， 然 后 就 将 代码 提交 


的 程序 员 们 都 一 


再 去 修改 测试 人 员 提出 的 bug， 这 一 切 看 起 来 都 像 教 科 书 上 描述 的 那样 地 
苦 代 码 的 沼泽 里 ， 即 使 有 文档 ， 也 读 不 懂 代码 ; 即使 pug 很 小 ， 也 不 敢 修改 代码 。 我 甚至 怀疑 ， 这 种 方 
开发 方法 ， 做 一 个 编程 操练 局 吧 ， 来 看 看 其 中 会 有 什么 问题 。 


结对 编程 其 实 一 点 都 不 神秘 ， 如 果 把 编程 比 作 打 网 络 游戏 ， 结 对 编程 就 好 比 两 个 人 结伴 去 打 魔 兽 ， 除 了 可 以 相互 学 习 切 磋 之 外 ， 还 能 相互 有 个 照应 。 一 起 来 看 看 本 书 的 第 一 个 编程 操练 。 


这 个 操练 是 我 于 2013 年 9 月 为 在 “北京 设计 模式 学 习 组 ”的 第 9 次 活动 中 操练 Observer 设 计 模式 而 编写 的 。 灵 感 来 
间 的 时 钟 。 我 在 想 ， 如 果 所 有 这 些 时 钟 都 走时 不 准 ， 酒 店 大 堂 服务 员 一 个 个 地 分 别 调 时 间 太 麻 烦 ， 而 这 位 服务 员 的 智能 手机 上 肯定 


时 ， 将 酒店 大 堂 墙壁 上 所 有 城市 的 时 钟 根 据 时 差 相应 地 自动 调 准 ， 那 该 多 方便 。 


假如 在 北京 一 家 酒店 的 大 堂 里 有 5 个 时 钟 ， 分 别 显示 北京 、 伦 敦 、 莫 斯 科 、 悉 
尼 比 UTC 时 间 早 10 小 时 ， 纽 约 比 UTC 时 间 晚 5 小 时 D]。 
自动 调整 准确 。 酒 店 世界 时 钟 和 服务 员 的 手机 时 钟 如 


时 ， 莫 斯 科比 UTC 时 间 早 4 小 时 ， 悉 
墙壁 上 那 5 个 城市 的 时 间 就 能 相应 地 


尼 和 纽约 


若 所 有 这 些 


1-1 所 示 。 


城市 的 时 钟 都 多 少 有 些 才 


E 时 不 准 ， 需 要 调整 时 间 时 ， 大 堂 服务 员 


于 我 在 酒店 下 枫 时 ， 在 大 堂 里 看 到 的 墙壁 上 悬挂 的 那些 显示 世界 上 各 个 主 
的 是 该 酒店 所 在 地 的 当地 时 间 ， 要 是 能 够 在 调 准 服务 员 手机 时 间 的 同 


城市 的 时 


的 时 间 。 其 中 ， 伦 敦 与 UTC (Coordinated Universal Time， 协 调 世界 时 ) 时 间 欠 一 致 ， 北 京 比 UTC 时 间 早 8 小 


只 需 调 准 


己 手 机 上 的 北京 时 间 ， 那 么 


图 1-1 


酒店 世界 时 钟 和 服务 员 的 手机 时 钟 


在 程序 员 中 ， 熟 悉 Java 语 言 的 人 数 相 对 较 多 。 那 么 咱们 能 不 能 用 Java 语 言 实现 上 面 这 个 编程 操练 呢 ? 


“好 吧 ， 需 求 已 经 说 得 很 清楚 了 。 咱 们 先 用 UML 和 Use Case 来 对 这 个 需求 进行 分 析 和 设计 吧 。” 


首先 把 功能 性 需求 整理 成 下 面 这 样 的 需求 列表 ， 并 编 上 号 。 


1) REQ01: 一 家 北京 的 酒店 大 堂 里 有 5 个 时 钟 ， 分 别 显示 北京 、 伦 敦 、 莫 斯 科 、 悉 尼 和 纽约 的 时 间 。 


2) REQO2: 伦敦 与 UTC 时 间 一 致 ， 北 京 比 UTC 时 间 早 8 小 时 ， 莫 斯 科比 UTC 时 间 早 4 小 时 ， 悉 尼 比 UTC 时 间 早 10 小 时 ， 纽 约 比 UTC 时 间 晚 5 小 时 。 


3) REQ03: 将 酒店 大 堂 服务 员 的 智能 手机 时 间 设 置 为 北京 时 间 。 


4) REQ04: 若 大 堂 墙壁 上 所 有 那些 城市 的 时 钟 都 或 多 或 少 有 些 走 时 不 准 ， 需 要 调整 时 间 时 ， 只 需 调 准 服务 员 手机 的 时 间 ， 那 么 墙 上 5 个 城市 的 时 钟 时 间 都 能 够 相应 地 自动 调整 准确 。 


把 需求 编 上 号 ， 将 来 实现 和 测试 这 些 需求 时 就 好 跟踪 了 。 


领域 模型 定义 “系统 能 够 做 什么 ”这 样 的 功能 需求 ， 重 在 解决 沟通 误解 的 问题 。 它 关注 项 目 中 所 有 概念 的 “准确 性 ” ， 需 要 建立 描述 问题 领域 的 通用 词汇 表 ， 来 消除 误解 和 增强 概念 的 准确 性 。 这 个 词 
汇 表 会 随 着 项 目的 进展 ， 不 断 地 完善 和 更 新 。 


设计 领域 模型 的 第 一 步 是 找 出 领域 类 。 从 上 面 那个 需求 列表 里 找 出 一 些 重要 的 名 词 ， 可 以 作为 初步 的 领域 类 。 


这 个 题目 重要 的 名 词 有 : 城市 时 钟 、 手 机 时 钟 和 UTC 时 间 ， 或 许 还 应 该 有 酒店 服务 员 。 


先 用 这 些 名 词 ， 以 后 再 继续 调整 。 下 一 步 可 以 创建 词汇 表 ， 来 描述 这 些 名 词 。 


词汇 表 如 表 1-1 所 示 。 


表 1-1 词汇 表 


城市 时 钟 CityClock 酒店 大 符 中 显示 各 个 城市 时 间 的 时 钟 
手机 时 钟 PhoneClock 负责 调整 大 党 时 钟 的 酒店 服务 员 的 手机 里 的 时 钟 


Coordinated Universal Time， 人 协调 世界 时 间 ， 是 全 世界 用 于 调整 时 钟 和 时 
间 的 主要 时 间 标 准 


酒店 服务 员 HotelEmployee 在 大 堂 中 调整 城市 时 钟 的 酒店 员工 


下 一 步 就 可 以 画 领 域 模型 类 图 了 。 为 了 让 领域 模型 类 图 更 有 条 理 ， 可 以 从 城市 时 钟 和 手机 时 钟 里 抽象 出 一 个 “时 钟 ” 类 。 现 在 可 以 先 在 词汇 表 中 添加 一 行 ， 表 示 “ 时 钟 ”。 


UTC 时 间 UtcTime 


在 词汇 表 中 添加 的 那 一 行 如 表 1-2 所 示 。 


表 1-2 词汇 表 中 增加 的 一 行 


中 文 词 条 英文 词 条 a X 
从 各 个 城市 时 钟 和 手机 时 钟 里 抽象 出 来 的 类 


时 钟 


城市 时 钟 和 手机 时 钟 都 继承 这 个 时 钟 类 ， 是 泛 化 关系 。 而 时 钟 类 中 又 包含 一 个 UTC 时 间 类 ， 是 聚合 关系 。 


领域 模型 类 图 如 图 1-2 所 示 。 


<<abstract>> 


Clock UtcTime 


HotelEmployee 


PhoneClock 


图 1-2 ”领域 模型 类 图 


接 下 来 ， 可 以 画 一 个 Use Case 用 例 


， 如 


1-3 所 示 。 


[ 
[ 


所 有 依赖 于 它 的 对 象 都 得 到 通知 并 被 自动 更 新 。” 这 不 正好 能 满足 当 调 整 手机 时 钟 的 时 间 ， 所 有 城市 的 时 钟 都 能 自动 更 新 时 间 这 个 需求 吗 ” 咱 们 可 以 把 上 面 的 领域 模型 类 图 照 着 “四 巨头 ” 画 的 类 图 


HotelEmployee 


Update the time of the phone clock hili 


Update the time of all city clocks 


1-3 ”Use Case 用例 图 


“咱们 不 妨 看 看 这 个 操练 的 场景 是 否 有 设计 模式 可 以 适用 ， 这 样 可 以 借鉴 前 人 的 经 验 ， 而 不 用 自己 闭门造车 。” 


首先 ,酒店 服务 员 这 个 角色 与 Update the time of the phone clock 这 个 用 例 打交道 ， 来 更 新 手机 时 钟 的 时 间 。 然 后 这 个 用 例会 调用 Update the time of all city clocks 这 个 用 例 ， 表 示 自 动 更 新 所 有 
城市 时 钟 的 时 间 。 


“可 以 快速 浏览 一 下 “四 巨头 ”的 23 个 设计 模式 由 的 意图 。 看 起 来 Observer 观察 者 模式 的 意图 正好 和 咱们 的 编程 操练 相 吻 合 。 定义 对 象 间 的 一 种 一 对 多 的 依赖 关系 ， 当 一 个 对 象 的 状态 发 生 改变 时 ， 
改 一 


在 “四 巨头 ”的 《设计 模式 》 一 书 中 ，Observer 模 式 的 UML 类 图 如 图 1-4 所 示 中 。 


Attach(Observer) 


Detach(Observer) for all o in observers { 


o->Update() 


SetState() o--- 


-J observerState = 
subject->GetState() 


图 1-4 “四 巨头 ” 书 中 的 Observer 模式 的 类 图 


更 新 后 的 领域 模型 类 图 如 图 1-5 所 示 。 


<<abstract>> <<abstract>> 


Clock 


图 1-5 更 新 后 的 领域 模型 类 图 


类 图 有 了 ， 下 面 可 以 参考 “四 巨头 ”的 类 图 来 细 化 咱们 的 类 图 。 在 每 个 类 上 添加 暴露 给 外 界 的 接口 ， 也 就 是 公共 方法 。 


细 化 后 的 类 图 如 图 1-6 所 示 。 


<<abstract>> 
TimeSubject 


+attach (name: String, clock: Clock) 
+detach (name: String) 
+notify() 


UtcTime 
+getUtcTime() 


+setUtcTime(utcTime: int) 
+notify() 


setUtcTime(int utcTime) { 


notify(); 


notify() { 
for (Clock clock : clocks) { 
clock.setLocalTime(utcTime) ; 


为 简化 起 见 ， 对 于 时 间 这 里 只 考虑 小 时 ， 所 以 时 间 都 


int 类 型 来 表示 。 


在 细 化 后 的 类 医 


中 ，TimeSubject 类 可 以 


for 循 环 来 调 


Clock 抽 象 类 有 一 个 私有 的 成 员 变 量 localTime， 
有 一 个 抽象 方法 setLocalTime () ， 用 来 设置 该 时 钟 的 


式 实现 了 这 个 方法 。 在 CityClock 类 中 ， 这 个 方法 的 实现 仅仅 是 把 传 入 的 参数 赋值 到 其 成 员 变 量 中 ;而 在 PhoneClock 类 中 ， 这 个 方法 的 实现 除了 赋值 外 ， 还 调 
utcTime 的 notify () 方法 ， 从 而 能 够 实现 自动 更 新 所 有 城市 的 时 间 。 


量 utcTime 的 setUtcTime () 方法 ， 来 触发 调 


一 个 名 叫 clocks 的 HashMap 来 保存 所 有 5 个 城市 的 Clock 类 | 
detach () 这 两 个 方法 。TimeSubject 类 的 notify () 方法 是 个 抽象 方法 ， 它 在 其 子 类 UtcTime 中 被 实现 ， 
其 中 保存 的 每 一 个 Clock 对 象 中 的 setLocalTime () 方法 ， 来 对 所 有 时 钟 的 当地 时 间 进 行 自 双 


当地 时 间 。 这 个 方法 之 所 以 是 抽象 的 ， 是 


clocks 


setLocalTime(int localTime) { 
this. localTime = LocalTime; 
utcTime.setUtcTime(localTime - 


UTC_OFFSET) ; 


图 1-6” 细 化 后 的 类 图 


<<abstract>> 
Clock 
-UTC_OFFSET: int 
-localTime: 


+setLocalTime(localTime:int) 


PhoneClock 
+setLocalTime(localTime: int) 


的 对 象 和 手机 时 钟 对 象 。 为 了 便于 向 这 个 HashMap 中 添加 或 删除 对 象 ， 需 要 有 attach () 和 


int 


人 


CityClock 
+setLocalTime(localTime:int) 


N 
setLocalTime(int localTime) { 
this. localTime = localTime; 
} 


体 实现 的 伪 代 码 在 


中 用 一 个 注解 框 标 出 来 了 ， 即 对 于 clocks 这 个 HashMap 成 员 变 量 ， 上 


[ 


更 新 。 而 这 个 notify 


于 保存 这 个 时 钟 所 表示 的 当地 时 间 。 它 还 有 另 一 个 私有 的 成 员 变量 UTC_OFFSET， 有 外 
因为 Clock 类 的 两 个 子 类 一 一 表示 手机 时 钟 


() 方法 ， 可 以 通过 UtcTime 类 的 setUtcTime () 方法 来 触发 调 


于 保存 它 的 每 一 个 子 类 的 实例 相对 于 UTC 时 间 的 时 差 。 
的 PhoneClock 类 和 表示 城市 时 钟 的 CityClock 类 一 一 


Clock 类 
不 同 的 方 


UtcTime 类 扩展 了 其 父 类 TimeSubject， 且 有 一 个 utcTime 私 有 成 员 变量 ， 用 来 保存 UTC 时 间 。 
现在 设计 文档 有 了 。 在 开始 编程 之 前 ， 咱 们 先 回 顾 一 下 这 一 章 所 做 的 工作 : 

1) 使 用 了 设计 驱动 的 开发 方法 ， 来 进行 有 关 酒 店 世界 时 钟 的 结对 编程 操练。 

2) 整理 出 了 需求 列表 ， 并 编 上 了 号 。 

3) 创建 了 领域 词汇 表 ， 从 中 找 出 领域 类 。 

4) 画 出 了 领域 模型 类 图 。 

5) 画 出 了 Use Case 用 例 图 

6) 根据 Observer 观察 者 设计 模式 ， 更 新 了 领域 模型 类 图 ， 并 画 出 了 细 化 后 的 类 图 。 


2] 有 关 编程 操 练 的 讨论 参见 附录 A。 

3] 如 无 特殊 说 明 ， 引 号 中 的 对 话 均 为 读者 所 说 。 全 书 同 。 
引 UTC 时 间 是 全 世界 用 于 调整 时 钟 和 时 间 的 主要 时 间 标 准 。 
5] 为 简单 起 见 ， 不 考虑 夏令 时 。 


1] 在 测试 后 行 的 开发 方法 中 ， 一 般 在 设计 和 编程 完成 之 后 ， 才 编写 测试 代码 并 进行 测试 。 


6] 参见 Erich Gamma, Richard Helm, Ralph Johnson 和 John Vlissides 撰 写 的 《设计 模式 》 一 书 。 
7 本 图 在 原 图 的 基础 上 ， 在 ConcreteSubject.SetState0 方 法 中 ， 添 加 了 一 个 调用 Notify0 的 注解 框 。 


第 2 章 “” 按 图 索 怠 地 编写 代码 


了 PhoneClock 类 中 UtcTime 类 型 


的 成 员 变 


现在 , 设计 文档 都 齐备 了 ，github 也 配 好 了 ， 安 装 了 JDK7 和 Maven， 空 项 目 已 经 
第 一 个 类 TimeSubject[21 了 。 


下 面 就 是 TimeSubject 类 的 代码 : 


Maven 建 好 了 。 还 安装 好 了 一 个 免费 使 


的 Intell IDEA[1]13.1 版 ，f 


来 编程 。 现 在 就 可 以 按照 细 化 后 的 类 图 来 编写 


public abstract class TimeSubject { 
protected Map<String, Clock> clocks = new HashMap<String, Clock>(); 
public void attach(String cityName, Clock clock) { 
clocks.put (cityName, clock); 
} 
public void detach(String cityName) { 
clocks. remove (cityName) ; 


} 
public abstract void notifyAllClocks () 7 


“我 有 个 疑问 。 这 段 代码 中 ，TimeSubject 类 依赖 Clock 类 ， 而 后 者 还 没有 创建 ， 您 就 开始 用 它 编程 了 。 为 什么 不 先 编写 Clock 类 呢 ?“ 


嗯 ， 好 问题 ! 先 编写 Clock 类 当然 可 以 。 不 过 先 编写 TimeSubject 类 会 有 额外 的 好 处 ， 就 是 能 让 IDEA 帮 助 咱们 创建 Clock 类 。 后 面 会 看 到 。 


如 果 按 照 类 图 来 实现 ， 抽 象 的 成 员 方法 的 名 字 notify () 已 经 被 java 语言 本 身 的 Object 类 给 占用 了 ，notifyAll () 也 被 占用 了 ， 所 以 只 好 把 notify () 改名 为 notifyAllClocks () 了 。 


现在 代码 中 Clock 显 示 为 红色 ， 表 示 这 个 类 还 没有 定义 。 不 过 现在 就 可 以 提交 代码 到 git。 


“ 啊 ? 代码 编译 还 未 通过 就 提交 ? 我 们 公司 可 是 要 求 我 们 直到 测试 运行 通过 才能 提交 代码 的 。” 


对 ， 你 们 公司 说 得 没 错 ， 不 过 我 认为 这 个 要 求 是 针对 某 种 特殊 情况 而 言 的 ， 即 版 本 管理 系统 的 代码 库 是 使 用 客户 端 -服务 器 这 种 集中 式 管 理 的 情况 。 你 们 公司 管理 代码 版 本 用 的 是 什么 工具 ? 


“SVN, ” 


咽 ，SVN 就 是 用 这 种 集中 式 管 理 的 方式 来 管理 代码 版 本 的 。 早 先 的 代码 管理 工具 CVS 也 是 用 这 种 方式 。 这 种 方式 最 明显 的 特点 就 是 一 旦 断 网 就 无 法 提交 代码 。 


“是 呀 ， 用 SVN 管 理 代码 必须 联网 。 我 在 家 办 公 的 时 候 ， 要 是 连 不 上 公司 网 络 ， 那 就 没 法 写 代码 了 。” 


现在 咱们 使 用 的 是 git， 这 是 一 种 分 布 式 的 代码 版 本 管理 工 这 种 分 布 式 的 工具 提交 代码 时 ， 代 码 仅仅 是 被 提交 到 使 用 git 的 这 人 台 计 算 机 的 本 地 代码 库 中 ， 尚 未 提交 到 远程 的 代码 库 中 。 所 以 即使 提交 
尚未 通过 编译 的 代码 到 本 地 ， 也 不 会 影响 在 远程 的 代码 库 上 进行 的 编译 工作 。 等 咱们 一 次 次 提交 到 本 地 的 代码 最 后 编译 运行 通过 了 ， 再 统一 push 到 远程 代码 库 也 不 迟 。 


在 提交 代码 之 前 ， 先 填写 Commit Message 提 交 注 解 。 


“ 哦 ， 我 以 前 一 直 都 不 填 Commit Message。” 


每 次 提交 代码 都 需要 填 Commit Message。 因 为 如 果 想 在 写 错 代码 时 能 回 退 到 写 错 前 的 代码 状态 ， 就 得 依靠 它 。 另 外 Commit Message 还 能 起 到 代码 注释 的 作用 。 


如 果 能 做 到 当 有 人 少量 代码 改动 时 就 频繁 地 把 代码 提交 到 本 地 代码 库 而 不 管 是 否 通过 编译 ， 且 每 次 提交 都 能 填写 有 关 此 次 代码 改动 的 意图 明确 的 Commit Message， 那 么 这 种 每 次 少量 目 意图 描述 清晰 的 
代码 提交 ， 一 方面 增强 了 将 来 阅读 代码 变动 的 可 读 性 ， 另 一 方面 当代 码 写 错 需 要 回 退 时 也 能 有 助 于 做 到 更 精细 的 回 退 。 


这 次 提交 的 Commit Message 不 妨 写成 Created and wrote class TimeSubject according to the class diagram.B] 


代码 提交 完 ， 现 在 就 可 以 创建 那个 标 红 的 Clock 类 了 。 在 IDEA 里 ， 可 以 把 光标 移 到 Clock 中 ， 然 后 按 Alt+ Enter 快 捷 键 ， 就 能 让 IDEA 自 动 帮 咱 们 写 这 个 类 了 。 


Clock 类 的 3 处 编译 错误 在 图 2-1 中 用 箭头 标 了 出 来 ， 图 中 还 显示 了 在 Clock 上 按 Alt+Enter 快 捷 键 后 出 现 的 创建 Clock 类 的 快捷 菜单 。 


:public abstract class TimeSubject { 
i protected Map<String, Clock> clocks = new HashMap<String, Clock>(); 


@ public void attach(String cityName, Clock clock) { 


» Create Class 'Clock' 


@ Create Enum 'Clock' 

@ Create Inner Class ‘Clock’ 
@ Create Interface ‘Clock’ 
= Add Maven Dependency... 


Bind Method Parameters to Fields. 

Create Field for Parameter ‘clock’ 

Define params default value 

Generate delegated method with default parameter value 
Make ‘private’ 

Make ‘protected’ 

Make package-local 


图 2-1 创建 Clock 类 的 快捷 菜单 


“ 哦 ， 这 么 方便 ! 您 要 是 不 说 ， 我 还 要 傻乎乎 地 一 点 点 地 写 呢 。” 


IDEA 所 创建 的 Clock 类 的 代码 如 下 所 示 (CM: Created class Clock.) : 


public class Clock { 
} 


按照 类 图 写 出 的 Clock 类 如 下 所 示 (CM: Wrote class Clock according to the class diagram.) : 


-public class Clock { 

+public abstract class Clock { 

+ private final int UTC_OFFSET = 0; 
+ private int localTime = 0; 

+ 

+ public abstract void setLocalTime (int localTime) ; 


上 面 的 代码 中 ， 带 有 “-” 号 的 行 表示 被 删除 的 行 ， 带 有 “+ ”号 的 行 表示 新 添加 的 行 。 上 面 的 代码 表示 用 后 面 5 个 带 有 “+” 号 的 行 蔡 换 前面 那 个 带 有 “-” 号 的 行 。 


Clock 类 写 完了 ， 提 交代 码 口 。 现 在 在 IDEA 中 ， 已 经 没有 编译 失败 的 错误 了 。 


接 下 来 根据 那个 类 图 ， 从 左 到 右 一 个 一 个 地 编写 剩 下 3 个 类 的 代码 。 首 先是 UtcTime 类 。 


创建 UtcTime 类 的 代码 如 下 所 示 (CM: Created class UtcTime.) : 


public class UtcTime extends TimeSubject { 
@Override 
public void notifyAllClocks() { 
} 

} 


再 来 实现 UtcTime 类 的 notifyAllClocks () 方法 。 


UtcTime 类 的 notifyAlIClocks () 方法 如 下 所 示 (CM: Implemented method UtcTime.notify-AllClocks () .) : 


public void notifyAl1Clocks() { 


for (Clock clock : super.clocks.values()) { 
clock.setLocalTime (Clock. toLocalTime (this.utcZeroTime) ) ; 


+++1 


} 
} 


吗 ， 类 图 中 utcTime 这 个 名 字 起 得 真 的 让 人 有 点 纠结 。 它 有 两 个 含义 ， 既 可 以 指 UtcTime 这 个 类 的 一 个 对 象 ， 也 可 以 指 UtcTime 这 个 类 中 用 来 保存 UTC 时 间 的 那个 成 员 变量 。 为 了 区 分 ， 把 后 者 改名 叫 


utcZeroTime， 表 示 与 UTC 时 差 为 0 的 时 间 。 所 以 在 细 化 后 的 类 图 中 ， 除 了 UtcTime 类 的 类 名 和 PhoneClock 类 的 utcTime 成 员 变 量 的 变量 名 之 外 ， 其 他 8 处 出 现 UtcTime 的 地 方 都 要 改 为 utcZeroTime。 另 外 
发 现 这 个 类 图 还 有 一 个 错误 ， 上 面 那 个 for 循 环 里 面 的 方法 clock.setLocalTime () 的 参数 ， 不 应 该 仅仅 从 utcTime 改 为 utcZeroTime， 还 应 该 把 它 转换 为 时 钟 所 表示 的 当地 时 间 ， 因 为 这 是 


clock.setLocalTime () 方法 的 接口 所 要 求 的 。 可 以 用 Clock 类 的 一 个 静态 方法 toLocalTime () 来 把 utcZeroTime 转 换 为 local time, 


刚 根据 那个 类 图 写 了 3 个 类 ， 就 发 现 了 那个 图 有 3 个 问题 需要 修改 : 一 个 是 notify () 方法 名 改 为 notifyAlliClocks () ， 一 个 是 把 8 处 utcTime 改 为 utcZeroTime， 还 有 一 个 是 for 循 环 里 面 的 那个 方法 的 参 


数 需要 转换 为 local time。 我 现在 就 把 那个 类 图 打印 一 份 。 您 一 边 写 代码 ， 我 一 边 用 红 笔 在 类 图 上 改 。 


目前 在 细 化 后 的 类 图 中 对 上 述 3 个 问题 做 出 的 修改 如 图 2-2 所 示 。 


<<abstract>> 
Clock 


-UIC_OFFSEI: int 
-localTime: int 


+attach (name: String, clock: Clock) 
+detach(name: String) 


> |+notify () 


CityClock 


ee CE 
+setLocalTime(localTime:int) 


PhoneClock 
+setLocalTime(localTime:int) 


Wime(utctime: int) 
+notify() 


tdTime {int urcaiime) 4 setLocalTime(int localTime) { 
this. localTime = LocalTime; 


} 


setLocalTime(int localTime) { 
this. localTi > localTime; 
utcTime.setUtcTime(localTime - UTC_OFFSET); 


for (Clock ciuch 7 clocks «Y 


clock. setLocalTime( ime); 
} Gock to wah Time th: S uteZeca lime, 


图 2-2 ”在 细 化 后 的 类 图 上 对 3 个 问题 进行 的 修改 


在 IDEA 中 ，UtcTime 类 中 的 notifyAllClocks () 方法 里 的 for 循 环 里 的 那 句 话 ， 有 两 处 标 出 了 红色 ， 是 因为 这 里 有 两 个 编译 错误 ， 一 个 是 Clock.toLocalTime () 这 个 静态 方法 没有 定义 ， 另 一 个 是 


this.utcZeroTime 这 个 成 员 变量 没有 定义 。 


UtcTime 类 的 2 处 编译 错误 在 图 2-3 中 用 箭头 标 了 出 来 。 


: public class [tcTime extends TimeSubject { 
@Override 
public void notifyAllClocks() { 
for (Clock clock : super.clocks.values()) { 


clock.setLocalTime(Clock.toLocalTime(this.utcZerolime)); 


MA NO 


图 2-3 ”UtcTime 类 的 2 处 编译 错误 


“ 换 我 来 编 会 儿 吧 。 咱 们 先 解 决 后 一 个 问题 。 把 光标 移动 到 utcZeroTime 上 ， 还 是 用 Alt+ Enter 快 捷 键 来 帮 有 咱们 创建 utcZeroTime 这 个 成 员 变量 。 这 个 快捷 键 真是 太 好 使 了 ! “ 


在 UtcTime 类 里 面 创建 出 的 utcZeroTime 成 员 变 量 的 代码 如 下 所 示 (CM: Added an int field utcZeroTime to class UtcTime.) : 


public class UtcTime extends TimeSubject { 
十 private int utcZeroTime; 


“ 接 下 来 处 理 前 一 个 问题 ， 在 类 Clock 中 添加 静态 方法 toLocalTime () 。” 


在 类 Clock 中 添加 静态 方法 toLocalTime () 的 代码 如 下 所 示 (CM: Added static method Clock.toLocalTime () .) : 


public abstract class Clock { 
private final int UTC OFFSET = 0; 
private static final int UTC OFFSET = 0; 
private int localTime = 0; ~ 
public abstract void setLocalTime (int localTime) ; 


1 


十 


public static int toLocalTime(int utcZeroTime) { 
return utcZeroTime + UTC_OFFSET; 
} 


十 十 十 十 


“为 了 让 静态 方法 toLocalTime () 能 够 访问 到 成 员 变 量 UTC_OFFSET， 把 这 个 成 员 变量 也 转变 为 静态 的 了 。 现 在 IDEA 里 面 没有 编译 错误 了 。 接 下 来 按照 细 化 后 的 类 图 ， 来 实现 UtcTime 类 的 成 员 变 量 
utcZeroTime 的 getter 和 setter。 ” 


在 IDEA 里 面 ， 可 以 先 把 光标 定位 到 UtcTime 类 的 成 员 变 量 utcZeroTime 下 面 ， 然 后 按 快捷 键 Alt+lnsert 调 出 Generate 快 捷 菜 单 ， 来 让 IDEA 帮 助 生成 utcZeroTime 的 getter 和 setter， 如 图 2-4 所 示 。 


public class Utclime extends TimeSubject { 
private int utcZerol ime; 


Constructor 
Getter 


@O0verride 
public void notifyAll 


for (Clock clock y) 1 
e(this .utcZerol ime) ); 


clock .setLoca _ Setter 
pr and TEE 
toString() 

Override Methods... 
Delegate Methods... 


Copyright 


图 2-4 Generate Rit #6 
“不 错 ， 还 是 快捷 键 方便 。” 


生成 的 UtcTime 类 的 成 员 变量 utcZeroTime 的 getter 和 setter 的 代码 如 下 所 示 (CM: Generated getter and setter of the field utcZeroTime of class UtcTime.) : 


public class UtcTime extends TimeSubject { 
private int utcZeroTime; 
public int getUtcZeroTime() { 

return utcZeroTime; 


} 


public void setUtcZeroTime (int utcZeroTime) { 
this.utcZeroTime = utcZeroTime; 


十 十 十 十 十 十 十 


} 


根据 细 化 后 的 类 图 中 的 注解 框 里 的 伪 代 码 ，UtcTime 类 中 的 setUtcZeroTime () 方法 里 面 应 该 有 个 notifyAllClocks () 方法 ， 现 在 就 可 以 加 上 它 。 


在 UtcTime 类 中 的 setUtcZeroTime () 方法 里 添加 notifyAllClocks () 方法 的 代码 如 下 所 示 (CM: Added method call notifyAllClocks () in method UtcTime.setUtcZeroTime () .) : 


public void setUtcZeroTime (int utcZeroTime) { 
this.utcZeroTime = utcZeroTime; 
+ notifyAl1Clocks () ; 
} 


接 下 来 ， 就 可 以 根据 类 图 编写 PhoneClock 类 了 。 


创建 类 PhoneClock 的 代码 如 下 所 示 (CM: Created class PhoneClock.) : 


+public class PhoneClock { 
+} 


然后 根据 类 图 中 注解 框 中 的 伪 代 码 来 实现 PhoneClock 类 中 的 setLocalTime () 方法 。 


PhoneClock 类 中 的 setLocalTime () 方法 的 代码 如 下 所 示 (CM: Implemented method Phone-Clock.setLocalTime () according to the class diagram.) : 


-public class PhoneClock { 

+public class PhoneClock extends Clock { 

+ @Override 

public void setLocalTime(int localTime) { 
this.localTime = localTime; 
this.utcTime.setUtcZeroTime (localTime - UTC_OFFSET) ; 


十 十 十 十 


} 
} 


“ 哦 ， 按 照 类 图 中 注解 框 中 的 伪 代 码 写 完 后 ， 在 IDEA 的 PhoneClock 类 里 面 ， 有 3 个 地 方 出 现 了 红色 的 编译 错误 。” 


PhoneClock 类 的 3 处 编译 错误 在 图 2-5 中 用 箭头 标 了 出 来 。 


public class PhoneClock extends Clock { 


@Override D 
public void /setLocalTime(int localTime) { 


this.localTime = LocalTime; 
this .utcTime.setUtcZeroTime(localTime - UTC OFFSET); 


fe 


图 2-5 ”PhoneClock 类 的 3 处 编译 错误 


咱们 一 个 一 个 看 这 3 个 编译 错误 。 第 1 个 编译 错误 是 this.localTime， 这 个 localTime 实 际 上 应 该 来 自 其 父 类 Clock， 所 以 应 该 是 super.localTime， 这 是 细 化 后 的 类 图 中 的 错误 。 相 应 地 ， 为 了 让 子 类 能 够 
访问 到 父 类 的 成 员 变 量 ， 父 类 Clock 中 的 成 员 变量 localTime 也 应 从 private 改 为 protected。 需 要 改 一 改 类 图 ， 把 这 个 问题 编 为 4 号 。 


<<abstract>> 
Clock 
-UTC_OFFSET: int 
pelocalTime: int 


+setLocalTime(localTime:int) 
A 


在 细 化 后 的 类 图 中 对 上 述 问题 做 出 了 对 4 号 问题 的 修改 ， 如 图 2-6 所 示 。 


clocks 


Ds: 6yAlllocks 


+setLocalTime( local Time:int) 


CityClock 
_————— 
+setLocalTime( LocalTime: int) 


+getUtctime () 
+setut Wine (ut Wine: int) 
+notify() 


seyUtdTime(int utdlime) { setLocalTime(int localTime) { setLocalTime(int localTime) { 
this.localTime = LocalTime; 


SUper this. localTi LocalTime ; 
utcTime.setUtcTime(localTime - UTC_OFFSET); } 


netrfy() { 
for (Clock clock : clocks) { 
cee he 


G) Clock .to veg\ Tire (Hh: $.uteZerg Time) 


} 


图 2-6 ”对 4 号 问题 的 修改 


第 2 个 编译 错误 是 this.utcTime。 这 是 由 于 在 类 图 中 PhoneClock 类 左 侧 凌 形 符号 所 表示 的 它 所 持 有 的 成 员 变 量 utcTime 还 未 创建 ， 一 会 再 创建 。 第 3 个 编译 错误 是 UTC_OFFSET， 这 个 错误 的 原因 与 第 1 
个 编译 错误 类 似 ， 即 UTC_OFFSET 实 际 上 也 应 来 自 父 类 ， 所 以 父 类 的 成 员 变 量 UTC_OFFSET 应 该 改 为 protected， 以 便于 子 类 访问 ， 而 不 应 该 是 private。 类 图 应 该 再 改 一 下 ， 在 图 中 把 这 个 问题 编 为 5 号 。 


在 细 化 后 的 类 图 中 对 5 号 问题 做 出 的 修改 如 图 2-7 所 示 。 


<<abstract>> 
TimeSubject 


+attach (name; String, clock: Clock) 
+detach (name: String) 


+notity () 


<<abstract>> 
© Clock 


UTC_OFFSET: int 
bélocalTime: int 


+setLocalTime(localTime:int) 
人 


" P 


Hot ifyAll Clocks 


ocnUtcTime 
+getutgfime() 
+setut Wime (ut ime: int) 
+notify() 


CityClock 
+setLocalTime( localTime:int) 


PhoneClock 
}+setLocalTime{ LocalTime: int) 


N 
setLocalTime(int localTime) { 


setLocalTime(int localTime) { 
this. localTime = localTime; 


SUpÈr this. localTi LocalTime; 
utcTime.setUtcTime(localTime - UTC_OFFSET); } 


for (Clock clock : cloc { 
clock .setLocalTime( ime); 


) G Clock HellTive( 由 5.okzeroTiee) 


} 


图 2-7 对 5 号 问题 的 修改 


类 图 改 好 后 ， 相 应 地 来 改 代码 。 


将 PhoneClock 类 中 的 setLocalTime () 方法 中 的 this.localTime 改 为 super.LocalTime 的 代码 如 下 所 示 (CM: Made field Clock.localTime protected.) : 


public class PhoneClock extends Clock { 
@Override 
public void setLocalTime(int localTime) { 
= this.localTime = localTime; 
+ super.localTime = localTime; 


将 父 类 Clock 中 的 成 员 变量 localTime 从 private 改 为 protected 的 代码 如 下 所 示 (CM 同上 ) : 


public abstract class Clock { 

private static final int UTC_OFFSET = 0; 
= private int localTime = 0; 
+ protected int localTime = 0; 


将 父 类 Clock 的 成 员 变量 UTC_OFFSET 从 private 改 为 protected 的 代码 如 下 所 示 (CM: Made field Clock.UTC_OFFSET protected.) : 


public abstract class Clock { 
= private static final int UTC_OFFSET = 0; 
+ protected static final int UTC_OFFSET = 0; 


“好 了 ， 现 在 该 修复 前 面 说 的 第 2 个 编译 错误 this.utcTime 了 。 还 是 把 光标 定位 到 PhoneClock 类 中 红色 的 utcTime 上 ， 用 Alt+ Enter 快 捷 键 来 帮 有 咱们 创建 这 个 成 员 变量 。 


在 PhoneClock 类 中 创建 utcTime 成 员 变量 的 代码 如 下 所 示 (CM: Added field PhoneClock.utcTime.) : 


public class PhoneClock extends Clock { 
+ private UtcTime utcTime; 


@Override 
public void setLocalTime(int localTime) { 


现在 IDEA 里 面 没 有 编译 失败 的 代码 了 。 根 据 类 图 现在 只 剩 下 最 后 一 个 类 CityClock 了 。 先 用 IDEA 创 建 一 个 新 类 CityClock。 


创建 新 类 CityClock 的 代码 如 下 所 示 (CM: Created class CityClock.) : 


+public class CityClock { 
+} 


根据 CityClock 的 类 图 和 其 注解 框 中 的 伪 代 码 ， 该 实现 它 所 继承 的 setLocalTime () 方法 了 。 


CityClock 类 的 setLocalTime () 方法 的 代码 如 下 所 示 (CM: Implemented method CityClock.setLocalTime () .) : 


-public class CityClock { 

+public class CityClock extends Clock { 

+ @override 

+ public void setLocalTime(int localTime) { 
+ super.localTime = localTime; 

+ } 

} 


这 里 又 发 现 一 个 类 图 中 的 错误 。 类 图 中 CityClock 类 的 注解 框 中 的 第 2 行 伪 代 码 的 this.localTime 应 该 是 super.localTime， 因 为 这 个 localTime 是 从 父 类 继承 下 来 的 。 需 要 再 改 一 下 类 图 ， 把 这 标记 为 6 号 
问题 。 


在 细 化 后 的 类 图 中 对 6 号 问题 做 出 的 修改 如 图 2-8 所 示 。 


在 编写 main () 方法 之 前 ， 先 回顾 一 下 本 章 的 内 容 。 


1) 按照 细 化 后 的 类 图 开始 编写 代码 。 


2) 使 用 分 布 式 代码 版 本 管理 工具 git 把 代码 暂时 提交 到 本 地 代码 库 ， 在 编译 未 通过 的 情况 下 ， 一 步 一 步 多 次 地 提交 代码 。 


<<abstract>> <<abstract>> 
TimeSubject © Clock 


+attach (name: String, clock :Clock) i on para 
+detach (name: String) pélocalTime: int 


+notity () +setLocalTime(localTime:int) 
人 


clocks 


一 


下 seAlclels 


+setLocalTime(localTime:int) 


CityClock 
+setLocalTime(localTime:int) 


+getUtofime() 
+SsetUtcyime(utcfime:int) 


+Betify() 


Vi N 
seyutdtime(int utolime) { setLocalTime(int localTime) { setLocalTime(int localTime) { 
r this. localTi localTime ; Cthis.localTime = LocalTime; 

} 


utcTime.setUtcTime(localTime - UTC_OFFSET); 


} 


rfy() 
for (Clock clock : clocks) { 
EA EEE A 


_ G) Clock ts xal Tire (4h: $.uteZerg Time) 


图 2-8 ”对 6 号 问题 做 出 的 修改 


3) 每 次 提交 代码 都 写 明 Commit Message 提 交 注 解 。 


4) 随 着 编程 的 进行 ， 修 改 了 细 化 后 的 类 图 中 的 多 处 错误 。 


5) 通过 操练 我 们 学 到 了 以 下 技能 : 


a) 在 IDEA 中 把 光标 定位 到 那些 红色 的 有 编译 错误 的 代码 上 ， 然 后 按 快 捷 键 At+ Enter， 能 快速 帮助 我 们 生成 所 需要 的 代码 。 


b) 如 果 能 做 到 当 有 少量 代码 改动 时 就 频繁 地 把 代码 提交 到 本 地 代码 库 而 不 管 其 是 否 通过 编译 ， 且 每 次 提交 都 能 填写 有 关 此 次 代码 改动 的 、 意 图 明确 的 Commit Message， 那 么 这 种 每 次 少量 且 意 图 


述 清晰 的 代码 提交 ， 一 方面 增强 了 将 来 阅读 代码 变动 的 可 读 性 ， 另 一 方面 当代 码 写 错 需 要 回 退 时 也 能 有 助 于 做 到 更 精细 的 回 退 。 


[1] 以 下 简称 IDEA。 


[2] 为 了 最 大 限度 地 体会 本 书 所 描述 的 结对 编程 的 过 程 ， 建 议 读者 在 自己 的 计算 机 上 ， 按 照 本 书 的 描述 ， 来 编写 代码 。 在 Windows、OS X 和 Linux 系 统 上 搭建 编程 操练 环境 的 步 又， 请 分 别 参见 附录 B~ 附 录 D。 


本 章 源 代 码 参 见 以 下 链接 : https://github.com/wubin28/book-taming-bad-code-waterfall。 

[3] 一 般 情 况 下 ， 后 文 每 段 代码 之 前 都 会 给 出 代码 提交 的 Commit Message， 并 与 本 书 在 github 上 的 源 代 码 一 一 对 应 。 
[4] CM 即 Commit Message， 余 同 。 

(5] 为 行文 简洁 起 见 ， 下 面 每 段 代码 都 会 进行 git 的 代码 提交 ， 文 中 不 黄 述 。 


第 3 章 Smain () 方法 测试 一 下 


[ 


“类 图 上 的 所 有 类 都 实现 完了 。 咱 们 现在 可 以 写 个 main () 方法 来 测试 一 下 了 。” 


先 创建 一 个 包含 main () 方法 的 类 HotelWorldClocksRunner。 


HotelWorldClocksRunner 类 的 代码 如 下 所 示 (CM: Added class HotelWorldClocksRunner with a main () method to have a try.) : 


+public class HotelWorldClocksRunner { 
+} 


然后 在 这 个 类 里 面 写 main () 方法 。 


main () 方法 的 代码 如 下 所 示 (CM: Added the main () method to class HotelWorldClocksRunner and wrote the expected code there.) : 


public class HotelWorldClocksRunner { 

public static void main(String[] args) { 
TimeSubject utcTime = new UtcTime(); 
utcTime.attach("beijing", new CityClock(8)); 
utcTime.attach("london", new CityClock(0)); 
utcTime.attach ("moscow", new CityClock(4)); 

utcTime.attach("sydney", new CityClock(10)); 

utcTime.attach ("newYork", new CityClock(-5)); 


Clock phoneClock = new PhoneClock (utcTime) ; 


) 
i 
i 
0) 

-5 
) 

phoneClock.setLocalTime (9) ; 


utcTime.printTimeOfAl11Clocks () ; 


十 十 十 十 十 十 十 十 十 十 十 十 十 


这 段 代 码 分 3 个 部 分 ， 第 1 部 分 是 做 准备 工作 ; 第 2 部 分 是 调用 手机 时 钟 的 setLocalTime () 方法 来 设 定时 间 为 北京 时 间 上 午 9 点 ， 以 触发 所 有 城市 时 钟 的 自动 调整 ; 第 3 部 分 是 打印 所 有 时 钟 的 本 地 时 


间 。 


在 第 1 部 分 中 ， 我 们 先 创 建 一 个 具有 TimeSubject 类 型 的 UtcTime 实 例 ; 再 把 5 个 城市 时 钟 的 实例 都 分 别 attach 到 这 个 UtcTime 实 例 上 ， 每 创建 一 个 城市 时 钟 实例 ， 都 把 该 城市 与 UTC 时 间 的 时 差 作 为 构 
造 器 的 参数 传 进 这 个 新 创建 的 实例 中 。 比 如 北京 比 UTC 时 间 早 8 小 时 ， 所 以 在 attach 北 京 时 钟 时 ， 用 new CityClock (8) 来 创建 北京 时 钟 实例 。 最 后 创建 手机 时 钟 实例 phoneClock， 并 把 上 面 准备 好 的 
UtcTime 实 例 作为 构造 器 的 参数 传 进去 ， 以 便 在 PhoneClock 类 的 setLocalTime () 方法 中 ， 调 用 UtcTime 类 的 setUtcZeroTime () 方法 ， 来 自动 调整 所 有 城市 时 钟 的 时 间 。 


现在 咱们 先 创 建 CityClock 类 的 带 有 时 差 参 数 的 构造 器 。 


“等 等 ! 我 觉得 带 有 utcTime 参 数 的 创建 PhoneClock 的 实例 那 句 话 写 得 有 问题 。 因 为 PhoneClock 和 CityClock 都 继承 同一 个 父 类 Clock， 为 何 创 建 CityClock 实 例 时 要 提供 时 差 参数 ， 而 创建 
PhoneClock 实 例 时 却 没有 提供 时 差 参数 ”难道 PhoneClock 的 实例 都 不 需要 时 差 参数 吗 ?“ 


问 得 好 ! PhoneClock 的 实例 在 创建 时 ， 确 实 也 和 创建 CityClock 实 例 时 一 样 ， 需 要 传 入 当地 时 间 与 UTC 时 间 之 间 的 时 差 。 需 要 改 一 改 这 个 main () 方法 。 


修改 main () 方法 中 创建 PhoneClock 实 例 的 代码 如 下 所 示 (CM: Updated the main () method to make the constructor of PhoneClock is the same with CityClock and add the UtcTime 


object to the phoneClock using method PhoneClock.setUtcTime () .) : 


utcTime.attach("moscow", new CityClock(4)); 
utcTime.attach("sydney", new CityClock(10)); 
utcTime.attach ("newYork", new CityClock(-5)); 
一 Clock phoneClock = new PhoneClock (utcTime) ; 
+ Clock phoneClock = new PhoneClock (8) ; 
+ phoneClock.setUtcTime (utcTime) ; 
phoneClock.setLocalTime (9) ; 


在 创建 PhoneClock 实 例 时 ， 把 北京 时 间距 离 UTC 时 间 的 时 差 8 作为 构造 器 的 参数 传 进去 ， 然 后 在 PhoneClock 类 上 增加 一 个 接口 setUtcTime () 方法 ， 来 把 utcTime 传 给 phoneClock 实 例 。 


“这 样 应 该 没 问题 了 。 再 更 改 一 下 类 图 ， 在 图 中 把 这 个 更 改 标记 为 7 号 。” 


在 细 化 后 的 类 图 中 对 7 号 的 更 改 如 图 3-1 所 示 。 


<<abstract>> 
TimeSubject 
+attach (name: String, clock :Clock) 


+detach (name: String) 
+notify () 


<<abst ract>> 
© Clock 
一 xurc_0FFSET: int 
KélocalTime: int 


+setLocalTime(localTime:int) 
人 


clocks 


" e 


notifyAll Clocks 


+getUtofime() 
+setUtAfime (utolime:int) 
potify() 


CityClock 


+setLocalTime(localTime:int) 


+ 


setLocalTime(int localTime) { 
SUPE this. localTi LocalTime ; 

utcTime.setUtcTime(localTime - UTC_OFFSET); 
} 


setLocalTime(int localTime) { 
P this. LocalTime = LocalTime; 


for (Clock clock : cloc { 
SG 


} ) Clock to vc Tre (Hh: 5. uteZerg Ti me) 


3-1 AERA TH HY RP 


这 个 main () 方法 有 不 少 编译 错误 ， 大 概 有 4 处 。 


HotelWorldClocksRunner 类 的 main () 方法 的 4 处 编译 错误 如 图 3-2 所 示 。 


public class HotelWorldClocksRunner { 

g public static void main(String[] args) — 

TimeSubject utcTime = new UtcTime(); 
utcTime.attach(“beijing", new CityClock(8)) ; 
utcTime.attach("“London", new CityClock(Q)); 
utcTime.attach(“moscow", new CityClock(4)) ; 
utcTime.attach("“sydney", new CityClock(10)); 
utcTime.attach("“newYork", new CityClock( -5)) 
Clock phoneClock = new PhoneClock(8) ; 
phoneClock .setUtcTime(utcTime) ; [一 一 

E 


© 


phoneClock .setLocalTime(9) ; 


utcTime.printTimeOfALLCLlocks() ; 
| 


@ 


3-2 ”HotelWorldClocksRunnet 类 的 main () 方法 的 4 处 编译 错误 


现在 从 上 往 下 看 看 这 4 个 编译 错误 。 第 1 个 编译 错误 是 CityClock 类 还 没有 一 个 接受 该 城市 与 UTC 时 间 的 时 差 的 构造 器 ; 第 2 个 编译 错误 是 PhoneClock 类 也 没有 接受 一 个 其 所 在 城市 与 UTC 时 间 的 时 差 的 
构造 器 ; 第 3 个 编译 错误 是 PhoneClock 类 还 没有 创建 setUtcTime () 方法 ; 第 4 个 编译 错误 是 UtcTime 类 还 没有 创建 printTimeOfAlIClocks () 方法 。 


接着 用 Alt+ Enter 快 捷 键 来 让 IDEA 帮 助 咱们 创建 这 些 默认 的 构造 器 和 方法 。 


现在 先 消除 第 1 个 编译 错误 ， 创 建 CityClock 类 的 带 有 时 差 参数 的 构造 器 。 


创建 CityClock 类 的 带 有 时 差 参数 的 构造 器 的 代码 如 下 所 示 (CM: Added constructor CityClock (int utcOffset) .) : 


public class CityClock extends Clock { 
public CityClock(int utcOffset) { 
super (); 


十 十 十 十 


@override 
public void setLocalTime(int localTime) { 


在 CityClock 类 的 带 有 时 差 参数 的 构造 器 里 ， 时 差 参 数 utcOffset 应 该 作为 参数 传 进 super () 方法 里 ， 并 在 父 类 Clock 里 也 添加 一 个 带 时 差 参数 的 构造 器 来 接收 这 个 参数 。 


在 CityClock 类 中 将 时 差 参数 utcOffset 作 为 参数 传 进 super () 方法 的 代码 如 下 所 示 (CM: Added constructor Clock (int utcOffset) .) : 


public class CityClock extends Clock { 
public CityClock(int utcOffset) { 
一 super (); 
+ super (utcOffset) ; 
} 


在 父 类 Clock 里 添加 一 个 带 时 差 参数 的 构造 器 的 代码 如 下 所 示 (CM 同 上 ) : 


public abstract class Clock { 
= protected static final int UTC_OFFSET = 0; 
中 protected static int UTC_OFFSET; 
protected int localTime = 0; 
public Clock(int utcOffset) { 

UTC_OFFSET = utcOffset; 
} 


十 十 十 十 


public abstract void setLocalTime (int localTime) ; 


因为 Clock 类 的 成 员 变 量 UTC_OFFSET 需 要 在 其 构造 器 里 赋值 ， 所 以 就 不 能 是 final 的 了 。 


再 消除 第 2 个 编译 错误 ， 创 建 PhoneClock 类 的 带 有 时 差 参 数 的 构造 器 。 


创建 PhoneClock 类 的 带 有 时 差 参 数 的 构造 器 的 代码 如 下 所 示 (CM: Created constructor PhoneClock (int utcOffset) .) : 


public class PhoneClock extends Clock { 
private UtcTime utcTime; 
public PhoneClock(int utcOffset) { 
super (utcOffset) ; 
} 


十 十 十 十 


现在 消除 第 3 个 编译 错误 ， 创 建 PhoneClock 类 的 setUtcTime () 方法 。 不 过 在 main () 方法 中 ， 变 量 phoneClock 被 声明 为 Clock 类 型 了 。 如 果 是 这 样 的 话 ，setUtcTime () 方法 应 该 在 父 类 Clock 中 
创建 ， 而 成 为 一 个 公共 接口 ， 这 使 得 Clock 类 的 另 一 个 子 类 CityClock 也 不 得 不 实现 这 个 它 并 不 需要 的 接口 。 这 就 不 大 合理 了 。 所 以 可 以 在 main () 方法 中 ， 把 变量 phoneClock 声 明 为 PhoneClock 类 型 ， 
这 样 setUtcTime () 方法 就 只 在 PhoneClock 类 上 创建 了 。 


在 main () 方法 中 ， 把 变量 phoneClock 声 明 为 PhoneClock 类 型 的 代码 如 下 所 示 (CM: Changed type of varialbe phoneClock in main () to be PhoneClock.) : 


utcTime.attach ("newYork", new CityClock(-5)); 
一 Clock phoneClock = new PhoneClock (8); 
+ PhoneClock phoneClock = new PhoneClock (8) ; 
phoneClock. setUtcTime (utcTime) ; 


“main () 方法 里 还 有 一 个 问题 ， 就 是 变量 utcTime 的 类 型 应 该 是 UtcTime， 而 不 应 该 是 其 父 类 TimeSubject。 因 为 根据 类 图 来 看 ，PhoneClock 类 持 有 一 个 UtcTime 的 实例 ， 以 便 调 


后 者 的 


setUtcZeroTime () 方法 。 而 这 个 方法 只 在 UtcTime 类 中 定义 了 ， 其 父 类 TimeSubject 并 没有 定义 。 所 以 为 了 调用 UtcTime 类 中 的 setUtcZeroTime () Aik, main () 方法 里 的 变量 utcTime 的 类 型 应 该 


是 UtcTime。 


在 main () 方法 中 ， 把 变量 utcTime 声 明 为 UtcTime 类 型 的 代码 如 下 所 示 (CM: Changed type of varialbe utcTime in main () to be UtcTime.) : 


public class HotelWorldClocksRunner { 
public static void main(String[] args) { 
= TimeSubject utcTime = new UtcTime(); 
+ UtcTime utcTime = new UtcTime(); 
utcTime.attach("beijing", new CityClock(8)); 


现在 可 以 创建 PhoneClock 类 的 setUtcTime () 方法 来 消除 第 3 个 编译 错误 了 。 


在 PhoneClock 类 中 创建 setUtcTime () 方法 的 代码 如 下 所 示 (CM: Created method Phone-Clock.setUtcTime (UtcTime) .) : 


super.localTime = localTime; 
this.utcTime.setUtcZeroTime (localTime - UTC_OFFSET) ; 
} 


public void setUtcTime(UtcTime utcTime) { 
this.utcTime = utcTime; 


十 十 十 十 


} 


现在 可 以 创建 UtcTime 类 的 printTimeOfAIIClocks () 方法 来 消除 第 4 个 编译 错误 了 。 这 个 方法 专门 是 为 测试 用 的 ， 所 以 就 不 在 类 图 中 画 出 来 了 。 


创建 UtcTime 类 的 printTimeOfAIIClocks () 方法 的 代码 如 下 所 示 (CM: Created method UtcTime.printTimeOfAIIClocks () .) : 


clock.setLocalTime (Clock.toLocalTime (this.utcZeroTime) ) ; 


} 


} 


+ 
$ public void printTimeOfAllClocks() { 

4 for (String clockName : super.clocks.keySet()) { 

+ System.out.println(clockName + ": " + super.clocks.get (clockName) .get'Time () ) ; 
+ 

+ 


因为 utcTime 能 从 其 父 类 TimeSubject 里 继承 Map 类 型 的 成 员 变量 clocks， 所 以 就 能 在 printTimeOfAIIClocks () 方法 里 写 一 个 循环 语句 ， 打 印 所 有 的 时 钟 名 称 和 时 间 。 


现在 就 差 创 建 Clock 类 的 getTime () 方法 了 。 


创建 Clock 类 的 getTime () 方法 的 代码 如 下 所 示 (CM: Created method Clock.getTime () .) : 


public static int toLocalTime (int utcZeroTime) { 
return utcZeroTime + UTC_OFFSET; 
} 


public String getTime() { 
return String.valueOf (this. localTime) ; 


十 十 十 十 


} 


看 起 来 现在 终于 可 以 运行 一 下 这 个 main () 方法 了 。 在 IDEA 里 打开 那个 main () 方法 ， 把 光标 定位 到 类 名 上 ， 然 后 按 Ctrl+ Shift+F10 组 合 键 运 行 一 下 。 结 果 出 来 了 ， 奇 怪 ， 所 有 的 城 


第 一 次 运行 main () 方法 的 结果 如 图 3-3 所 示 。 


和 的 时 间 都 是 9 


“现在 的 问题 是 ， 除 了 北京 以 外 ， 其 他 所 有 城市 的 当地 时 间 都 是 错 的 ， 而 且 都 是 9。 加 个 断 点 调试 一 下 吧 。” 
在 调试 前 ， 咱 们 先 看 看 这 章 做 了 什么 工作 : 
1) 开始 编写 main () 方法 ， 并 通过 打印 语句 ， 测 试 了 一 下 先前 按照 细 化 后 的 类 图 所 编写 的 代码 。 


2) 在 创建 PhoneClock 的 实例 时 发 现 并 修复 了 构造 器 的 参数 问题 。 


3) 先 在 main () 方法 中 编写 调用 了 和 暂时 不 存在 但 期 望 存在 的 接口 的 代码 ( 即 意图 代码 ) ， 然 后 循 着 这 些 意图 代码 的 红色 编译 错误 ， 来 编写 生产 代码 以 消除 这 些 错误 。 


4) 修改 细 化 后 的 类 图 以 反映 设计 的 修改 。 
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phoneClock .setUtcTime(utcTime) ; 
phoneClock .setLocalTime(Q) ; 


utcTime.printTimeOfALLCLocks() ; 
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Process finished with exit code 0 


图 3-3 ”第 一 次 运行 main () 方法 的 结果 


第 4 章 ”调试 一 下 


先 看 看 需要 在 哪里 加 断 点 。 从 main () 方法 看 起 。 最 后 一 句 utcTime.printTimeOfAIIClocks () 仅仅 是 打印 clock 中 保存 的 当地 时 间 的 结果 ， 而 结果 在 打印 前 已 经 是 错 的 了 。 所 以 需要 检查 给 每 个 clock 
的 当地 时 间 赋 值 的 地 方 。 这 件 事 在 main () 方法 中 ， 是 由 “phoneClock.setLocalTime (9) ; ”这 句 话 来 做 的 ;而 在 PhoneClock 类 的 setLocalTime () 方法 中 ， 这 件 事 又 委托 给 了 UtcTime 类 的 
setUtcZeroTime () 方法 ; 而 在 UtcTime 类 的 setUtcZeroTime () 方法 中 ， 这 事 又 委托 给 该 类 的 notifyAllClocks () 方法 了 。notifyAllClocks() 方法 里 有 一 个 for 循 环 ， 用 来 给 Map 中 保存 的 每 一 个 城市 
时 钟 的 当地 时 间 进 行 赋值 。 我 们 可 以 在 这 个 for 循 环 里 的 那个 语句 上 加 一 个 断 点 。 


在 UtcTime 类 的 notifyAlIClocks () 方法 里 的 for 循 环 里 加 断 点 ， 如 图 4-1 所 示 。 


public class UtcTime extends TimeSubject { 
private int utcZeroTime; 


public int getUtcZeroTime() { return utcZeroTime; } 


public void setUtcZeroTime(int utcZeroTime) { 
this .utcZerolTime = utcZerolime; 
notifyAlLlClocks() ; 


} 


@Override 
public void hotifyAllClocks() { 
for (Clock clock : super.clocks.values()) { 


图 4-1 ”在 for 循 环 里 加 断 点 
“在 加 断 点 的 这 个 语句 中 ， 真 正 计算 城市 时 钟 的 当地 时 间 的 是 Clock 类 的 静态 方法 toLocalTime () 。 在 这 个 方法 里 的 唯一 一 条 return 语 句 上 也 加 上 断 点 。” 


在 Clock 类 的 toLocalTime () 方法 里 的 return 语 句 上 加 断 点 ， 如 图 4-2 所 示 。 


eo ma abstract class Clock { 
protected static int UTC_OFFSET; 
protected int LocalTime = Q; 


public Clock(int utcOffset) { 
UTC_OFFSET = utcOffset; 
} 


public abstract void setLocalTime(int LocalTime) ; 


public static int ftoLocalTime(int utcZeroTime) { 


图 4-2 ”在 Clock 类 的 toLocalTime () 方法 里 的 return 语 句 上 加 断 点 


“在 IDEA 中 以 debug 方 式 运行 main () 方法 ， 程 序 停 到 了 第 1 个 断 点 上 ， 即 首次 进入 UtcTime 类 的 noitfyAllClocks () 方法 中 的 for 循 环 中 的 那 条 语句 上 。 单 击 下 面 的 变量 值 可 以 观察 一 下 。“ 


第 1 个 断 点 : 首次 进入 UtcTime 类 的 noitfyAllClocks () 方法 中 的 for 循 环 中 的 那 条 语句 的 变量 值 如 图 4-3 所 示 。 
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= this = {tbc.waterfall.UtcTime@415} 
= i$ = {java.util. HashMap $Valuelterator@421} 
= clock = {tbc.waterfall. CityClock@422} 
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| | J% 2: Favorites 


@6& TODO Æ Terminal M 9: Changes 


图 4-3 首次 进入 for 循 环 中 的 变量 值 


“刚刚 进入 这 个 for 循 环 时 ，clock 的 值 用 @422 来 标记 。 在 下 面 的 clocks 这 个 Map 里 面 ， 对 应 @422 的 是 伦敦 的 时 钟 ， 它 的 localTime 被 初始 化 为 0， 一 切 正常 。 按 F8 键 让 程序 继续 执行 ， 结 果 停 到 了 第 2 
个 断 点 上 ， 即 Clock 类 的 静态 方法 toLocalTime () 里 面 那 条 return 语 句 上 。” 


第 2 个 断 点 : Clock 类 的 静态 方法 toLocalTime () 里 面 那 条 return 语 句 的 变量 值 如 图 4-4 所 示 。 
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«3 7: Structure 


Debug B HotelWorldClocksRunner 


Debugger | 国 Console -I ites 3 


e; "public abstract class Clock { 
protected static int UTC_OFFSET; 
protected int LocalTime = Q; 


public Clock(int utcOffset) { 
UTC_OFFSET = utcOffset; 


} 


public abstract void setLocalTime(int LocalTime) ; 


public static int toLocalTime(int utc/arolime) { 
return utcZ 


} 


public String getTime() { 
return String.valueOf(this.localTime) ; 


局 notifyallClocks():21, UtcTime (tbc.w 
setUtcZeroTime():15, UtcTime (tbc 
局 setLocalTime():16, PhoneClock (tbd 
main():17, HotelWorldClocksRunnet 


viR E SE EIE n 


局 Frames +"| | & Variables 


Bmain@ling... hat + 本 | 了 @ static = tbc.waterfall. Clock 


@ UTC_OFFSET =8 


图 utcZeroTime = 1 < 
已 一 
M UTC_OFFSET = 8 >z, Asy 3 


图 4-4 ”Clock 类 中 那 条 return 语 名 的 变量 值 


“这 里 就 有 问题 了 。Clock 类 的 静态 方法 toLocalTime () 所 做 的 事情 ， 应 该 是 将 传 入 的 UTC 时 间 ， 加 上 伦敦 与 UTC 时 间 的 时 差 UTC_OFFSET， 来 生成 伦敦 的 当地 时 间 并 返回 。 从 下 面 的 变量 值 来 看 ， 传 
入 的 UTC 时 间 是 1， 这 没有 错 ， 因 为 在 那个 main () 方法 中 ，phoneClock 创 建 时 传 入 的 时 差 是 北京 与 UTC 时 间 的 时 差 8， 后 面 phoneClock.setLocalTime (9) 中 设置 的 本 地 时 间 是 9 点 ， 所 以 UTC 时 间 应 该 
是 1。 而 伦敦 与 UTC 时 间 的 时 差 UTC_OFFSET， 在 main () 方法 创建 伦敦 时 钟 时 已 经 通过 构造 器 的 参数 设置 为 0 了 ， 这 里 却 是 8。” 


分 析 得 没 错 。 问 题 出 在 Clock 类 中 的 成 员 变量 UTC_OFFSET 不 应 该 是 静态 的 。 在 Clock 类 中 设计 一 个 成 员 变量 UTC_OFFSET 的 初衷 是 让 该 类 的 每 一 个 实例 ， 即 城市 时 钟 或 手机 时 钟 ， 都 拥有 自己 的 
UTC_OFFSET， 以 表示 每 个 时 钟 所 在 城市 与 UTC 时 间 的 各 自 的 时 差 。 而 UTC_OFFSET 目 前 是 Clock 类 的 静态 的 成 员 变量 ， 静 态 成 员 变 量 意味 着 该 变量 属于 Clock 类 ， 被 每 一 个 该 类 的 实例 所 共享 ， 所 以 把 


UTC_OFFSET 定 义 为 静态 的 就 实现 不 了 上 述 初衷。 


“对 。 静 态 的 UTC_OFFSET 现 在 被 各 个 Clock 类 的 实例 所 共享 ， 每 一 个 Clock 类 的 实例 创建 时 ， 构 造 器 都 会 重 写 这 个 静态 成 员 变量 。 在 main () 方法 中 最 后 一 个 创建 Clock 类 的 实例 是 new 
PhoneClock (8) 语句 ， 所 以 UTC_OFFSET 最 终 被 设置 为 98 了， 并 且 令 所 有 的 Clock 类 及 其 子 类 的 实例 的 UTC_OFFSET 都 是 8， 而 UTC 时 间 是 1， 两 者 相 加 就 是 本 地 时 间 9。 难 怪 所 有 城市 时 钟 的 本 地 时 间 最 后 


全 是 9 呢 。” 


现在 首先 要 把 Clock 类 的 UTC_OFFSET 成 员 变 量 的 static 关 键 字 给 去 掉 。 


去 掉 Clock 类 的 UTC_OFFSET 成 员 变 量 的 static 关 键 字 的 代码 如 下 所 示 (CM: The field UTC_OFFSET of class Clock must not be static so that all subclasses could have its own 


UTC_OFFSET.That's the root cause of the bug that the local time of all city clocks are set to the same time.) : 


public abstract class Clock { 

= protected static int UTC_OFFSET; 

+ protected int UTC_OFFSET; 
protected int localTime = 0; 


既然 成 员 变 量 UTC_OFFSET 不 再 是 静态 的 了 ， 那 么 Clock 类 的 静态 方法 toLocalTime () 也 没有 存在 的 必要 了 。 


删除 Clock 类 的 静态 方法 toLocalTime () 的 代码 如 下 所 示 (CM: Removed the static method Clock.toLocalTime () .) : 


public abstract void setLocalTime (int localTime); 
public static int toLocalTime(int utcZeroTime) { 
return utcZeroTime + UTC_OFFSET; 


TEE 


public String getTime() { 
return String.valueOf (this.localTime) ; 


Clock 类 的 静态 方法 toLocalTime () 被 删除 了 ， 但 将 UTC 时 间 转 换 为 时 钟 所 表示 的 当地 时 间 并 赋值 给 Clock 的 实例 的 成 员 变 量 localTime 这 件 事 还 是 需要 做 的 ， 所 以 可 以 在 Clock 类 上 增加 一 个 接口 ， 用 


来 做 这 件 事 。 这 个 接口 可 以 叫 setLocalTimeFromUtcZeroTime () ， 类 图 也 需要 添上 这 个 接口 ， 这 应 该 是 8 号 改动 。 


在 细 化 后 的 类 图 中 8 号 更 改 如 图 4-5 所 示 。 


<<abstract>> 
TimeSubject 


+attach(nmame: String, clock: Clock) 
+detach(name: String) 
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elocalTime: int 
+setLocalTime(localTime:int) 
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clocks 


CityClock 
+setLocalTime(localTime:int) 


setLocalTime(int localTime) { setLocalTime(int localTime) { 
SUPE this. local Ti localTime; p ~this.localTime = LocalTime; 
utcTime.setUtcTime(localTime - UTC_OFFSET); 


for (Clock clock : clog { 
clock. setLocalTime( ime); 


v ) Clock .to xol Tire (4h: 5. ufeZerg Time) 


4-5 在 细 化 后 的 类 图 中 8 号 的 更 改 


在 UtcTime 类 中 的 notifyAlIClocks () 方法 中 ， 将 对 Clock 类 的 接口 setLocalTime () 的 调用 改 为 对 新 接口 setLocalTimeFromUtcZeroTime () 的 代码 如 下 所 示 (CM: Expected class Clock to 


have an interface of setting local time from UTC zero time in method UtcTime.notify-AllClocks () .) : 


public void notifyAl1Clocks() { 
for (Clock clock : super.clocks.values()) { 
= clock.setLocalTime (Clock.toLocalTime (this.utcZeroTime) ) ; 
+ clock.setLocalTimeFromUtcZeroTime (this.utcZeroTime) ; 


} 


“这 个 新 接口 还 未 实现 ， 还 是 用 Alt+ Enter 快 捷 键 来 让 IDEA 帮 助 实现 它 。” 


实现 Clock 类 的 新 接口 setLocalTimeFromUtcZeroTime () 的 代码 如 下 所 示 (CM: Created method Clock.setLocalTimeFromUtcZeroTime () .) : 


public String getTime() { 
return String.valueOf (this. localTime) ; 
} 


public void setLocalTimeFromUtcZeroTime (int utcZeroTime) { 


4 
+ 
+ this.localTime = utcZeroTime + this.UTC_OFFSET; 
+ } 


} 


再 运行 一 下 main () 方法 。 


第 2 次 运行 main () 方法 后 的 结果 如 图 4-6 所 示 。 


Run ‘= HotelWorldClocksRunner 


fopt/jdk1.7.@ 51/bin/java -Didea. launch 
london: 1 
moscow: 5 


beijing: 9 A IVR 
newYork: -4 < 一 -一 12E 
sydney: 11 


Process finished with exit code 日 


4-6 第 2 次 运行 main () 方法 后 的 结果 


城市 时 钟 的 当地 时 间 基 本 上 都 正确 了 ， 除 了 纽约 的 时 间 是 -4， 基 本 上 都 正确 了 ， 还 有 些 问 题 。 这 个 问题 的 原因 是 咱们 目前 用 整数 来 代表 时 间 ， 当 时 间 运 算 超 出 0 到 23 这 个 范围 时 ， 程 序 需要 处 理 ， 否 则 
就 会 出 现 -4 这 种 情况 。 咱 们 可 以 找到 进行 时 间 运 算 的 地 方 ， 就 在 Clock 类 中 的 setLocalTimeFromUtcZeroTime () 方法 中 ， 可 以 将 运算 式 utcZeroTime+this.UTC_OFFSET 作 为 参数 传 入 Clock 类 的 新 的 
makeHourWithin0To23 () 静态 方法 里 ， 这 个 静态 方法 就 是 处 理 上 述 时 间 范 围 的 。 


在 Clock 类 中 的 setLocalTimeFromUtcZeroTime () 方法 中 ， 将 运算 式 utcZeroTime+this.UTC_OFFSET 作 为 参数 传 入 Clock 类 的 makeHourWithin0To23 () 静态 方法 的 代码 如 下 所 示 (CM: Wrote 


client code of the expected new interface Clock.makeHourWithin0To23 () in Clock.setLocalTimeFromUtcZeroTime () .) : 


public void setLocalTimeFromUtcZeroTime (int utcZeroTime) { 
= this.localTime = utcZeroTime + this.UTC_OFFSET; 
+ this.localTime = Clock.makeHourWithin0To23 (utcZeroTime + this.UTC_OFFSET) ; 
} 
} 


“Clock 类 的 这 个 makeHourWithin0To23 () 静态 方法 还 未 创建 ， 下 面 就 创建 它 。” 


Clock 类 的 静态 方法 makeHourWithin0To23 () 的 创建 代码 如 下 所 示 (CM: Created and implemented method Clock.makeHourWithin0To23 () .) : 


public void setLocalTimeFromUtcZeroTime (int utcZeroTime) { 
this.localTime = Clock.makeHourWithin0To23 (utcZeroTime + this.UTC_OFFSET) ; 
} 


private static int makeHourWithin0To23(int hour) { 
return (hour + 24) % 24; 


十 十 十 十 


} 


“现在 再 运行 一 下 main () 方法 。” 


第 3 次 运行 main () 方法 的 结果 如 图 4-7 所 示 。 


fopt/jdk1.7.0 51/bin/java -Didea. lau 
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moscow: 5 
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newYork: 20 
sydney: 11 


Process finished with exit code 日 


avorites 


图 4-7 第 3 次 运行 main() 方法 的 结果 
“这 次 终于 看 起 来 没有 问题 了 ! " 


虽然 运行 结果 符合 期 望 ， 但 是 这 种 测试 后 行 的 开发 方法 还 是 暴露 出 下 面 这 些 问题 : 


in 


1) 文档 经 常 与 代码 缺乏 同步 造成 理解 偏差 。 即 使 这 个 编程 操练 很 小 ， 然 而 咱们 在 纸 上 对 细 化 后 的 类 图 做 了 多 达 8 处 的 修改 。 而 且 以 后 若 继续 开发 或 修复 bug， 还 得 继续 修改 这 个 文档 来 同步 。 实 际 上 ， 
我 们 不 仅 要 同步 这 个 细 化 后 的 类 图 ， 还 要 在 变化 发 生 时 同步 前 面 所 生成 的 诸如 需求 列表 、 领 域 词汇 表 、 领 域 模型 类 图 和 Use Case 用 例 图 这 些 文档 。 这 个 同步 的 工作 如 果 靠 人 来 做 ， 不 仅 费 时 费力 ， 还 不 可 
靠 。 因 为 代码 是 程序 员 写 的 ， 所 以 维护 像 类 图 这 样 的 文档 与 代码 一 致 这 项 工作 ， 只 能 由 程序 员 自己 来 做 。 但 在 项 目 进度 的 压力 下 ， 有 几 个 程序 员 能 坚持 做 这 样 繁琐 的 维护 工作 呢 ? 如 果 无 法 坚持 同步 文档 ， 
那么 这 就 好 比 “ 刻 舟 求 剑 ”， 只 要 您 不 再 刻 “ 记 号 ”来 同步 文档 ， 不 断 变化 的 代码 会 让 您 无 法 根据 刚刚 刻下 的 “记号 ”找到 您 需要 的 “ 剑 ”。 测 试 后 行 的 开发 方法 是 把 文档 作为 开发 团队 成 员 之 间 沟 通 的 基 
础 工具 的 。 而 这 些 过 时 的 文档 ， 随 着 时 间 的 推移 ， 会 越 来 越 离谱 ， 最 终 会 变 成 一 个 “撒谎 的 路 标 ”， 其 效果 还 不 如 没有 路 标 。 虽 然 能 够 通过 一 些 工具 来 让 代码 与 类 图 相互 转换 ， 但 是 转换 过 来 的 类 图 过 一 段 
时 间 还 会 过 时 。 


2) Smain () 方法 进行 的 测试 无 法 让 计算 机 自动 判断 软件 行为 是 否 符合 预期 而 导致 效率 低下 。 咱 们 编写 的 那个 测试 用 的 main () 方法 ， 虽 然 帮助 我 们 发 现 了 城市 时 钟 的 时 间 全 是 9 点 和 出 现 -4 点 这 些 
问题 ， 但 预期 的 执行 结果 是 保存 在 人 脑 中 的 ， 每 次 测试 都 要 手工 运行 main () 方法 ， 并 靠 眼睛 和 大 脑 去 判断 main () 方法 的 输出 结果 是 否 符合 人 脑 中 的 预期 值 ， 不 但 劳 神 费力 ， 而 且 效 率 低 下 。 


3) 问题 产生 后 没 能 立即 发 现 而 耽误 修复 时 间 。 那 个 城市 时 钟 的 时 间 全 是 9 点 和 出 现 -4 点 这 些 问题 ， 直 到 写 main () 方法 时 才 发 现 。 能 否 早 一 些 发 现 呢 ? 每 个 公司 的 主管 都 知道 ， 软 件 缺 陷 发 现 得 越 早 ， 
所 花费 的 时 间 和 金钱 就 越 低 。 如 果 程序 员 觉 得 不 能 让 测试 工程 师 太 清闲 ， 就 不 写 main () 方法 来 测试 ， 而 直接 把 写 完 的 生产 代码 丢 给 测试 工程 师 去 测试 ， 那 么 经 常会 出 现 这样 的 情况 : 上 述 问题 会 等 到 测试 
工程 师 读 文档 、 写 测试 用 例 、 搭 建 测试 环境 、 运 行 测试 这 一 系列 工作 完成 后 才 被 测试 出 来 ; 然后 测试 工程 师 会 兴奋 地 在 bug 跟 踪 系统 里 填写 bug 报 告 ， 并 且 贴 各 种 截屏 、 抓 各 种 log， 然 后 报告 给 开发 经 理 ; 
开发 经 理会 皱 着 眉头 地 按 优先 级 对 这 些 bug 排 序 ， 并 分 配给 当初 开发 这 个 代码 的 程序 员 ; 于 是 这 个 程序 员 不 耐烦 地 停 下 手中 的 工作 ， 打 开 bug 跟 踪 系 统 ， 读 元 长 的 bug 报 告 ， 看 各 种 截屏 和 log， 然 后 搭建 环 
境 重 现 问题 ， 并 试图 回想 当初 是 如 何 编程 的 ， 如 果 幸 运 地 找到 了 问题 所 在 ， 这 才能 最 后 修复 这 个 问题 。 上 面 整个 过 程 或 许 会 长 达 好 几 天 ， 像 黑洞 一 样 无 情 地 耗费 了 测试 工程 师 、 开 发 经 理 和 程序 员 的 大 量 工 
作 时 间 ， 让 他 们 没有 足够 的 时 间 来 做 更 重要 的 事情 ， 导 致 程序 员 更 没有 时 间 自 己 做 测试 ， 进 而 开启 了 恶性 循环 的 黑洞 。 最 终 软 件 缺陷 发 现 得 越 来 越 晚 ， 浪 费 的 时 间 和 金钱 越 来 越 多 。 如 果 程序 员 能 在 编写 完 
有 问题 的 代码 后 立即 就 知道 这 个 问题 ， 那 么 这 个 黑洞 是 不 是 完全 可 以 消除 呢 ? 


4) 照搬 设计 模式 导致 设计 出 不 必要 的 抽象 ， 编 写 出 从 未 被 调用 的 方法 造成 时 间 浪 费 。TimeSubject 这 个 父 类 和 其 子 类 UtcTime 是 否 可 以 合并 呢 ? 假如 TimeSubject 有 多 个 子 类 ， 那 么 把 这 些 子 类 的 共性 
提取 出 来 而 形成 TimeSubject 这 个 父 类 ， 还 是 可 以 理解 的 。 但 是 目前 父 类 TimeSubject 只 有 一 个 子 类 UtcTime。 完 全 可 以 把 子 类 UtcTime 并 入 父 类 TimeSubject 中 ， 当 将 来 有 TimeSubject 类 的 新 的 子 类 时 ， 
比如 出 现 了 另 一 种 新 的 世界 计时 系统 时 ， 再 提取 TimeSubject 这 个 父 类 也 不 迟 。 不 必要 的 抽象 增加 了 程序 员 理解 代码 的 复杂 性 ， 无 情 地 消耗 着 程序 员 的 宝贵 时 间 。 当 初 为 什么 要 有 TimeSubject 类 呢 ? 都 是 照 
搬 “ 四 巨头 ”的 类 图 若 的 祸 。TimeSubject 类 的 detach () 方法 和 UtcTime 类 的 getUtcZeroTime () 方法 是 根据 “四 巨头 ”所 画 的 Observer 设计 模式 的 类 图 编写 出 来 的 ， 但 是 却 没有 被 任何 代码 调用 。 程 
序 员 每 次 在 维护 代码 时 ， 都 会 阅读 这 些 从 未 被 调用 的 代码 ， 这 会 浪费 程序 员 的 宝贵 时 间 。 


5) 程序 调试 过 程 无 法 让 计算 机 来 蔡 代 并 自动 化 地 反复 使 用 ， 导 致 代码 维护 时 间 剧 增 。 虽 然 我 们 的 程序 出 问题 时 ， 用 设置 断 点 调试 程序 的 办 法 ， 能 仔细 观察 相关 变量 的 取 值 变化 ， 并 解决 问题 ， 但 这 个 过 
程 很 繁琐 : 首先 需要 在 IDE 里 把 程序 运行 起 来 (有 些 系统 甚至 无 法 在 IDEI1] 里 运行 ， 而 只 能 看 log 这 样 的 日 志 ) ， 然 后 重 现 错误 ， 观 察 错误 表现 ， 定 位 错误 ， 猜 测 出 错 点 ， 并 相应 地 设置 断 点 ， 再 debug 运 行 


程序 ， 观 察 断 点 处 的 变量 值 ， 


分 析 并 查找 错误 。 这 个 过 程 是 不 是 很 麻烦 ?但 最 要 命 的 不 是 麻烦 ， 而 是 这 个 人 工 的 过 程 无 法 让 计算 机 来 蔡 代 并 自动 化 地 反复 使 用 。 如 果 每 次 发 现 bug 都 这 样 繁琐 地 做 一 遍 这 样 


的 debug 过 程 ， 那 么 debug 也 将 会 像 黑 洞 一 样 无 情 地 耗费 程序 员 的 大 量 时 间 和 精力 。 


如 果 把 上 面 列 出 的 5 个 问题 归纳 一 下 ， 可 以 看 出 测试 后 行 的 开发 方法 如 下 : 


1) “文档 经 常 与 代码 缺乏 同步 ”， 会 让 这 些 文档 的 读者 一 一 包括 程序 员 、 测 试 工程 师 、 产 品 专家 等 一 一 在 理解 代码 行为 方面 反馈 迟缓 。 


2) “ 写 main () 方法 进行 的 测试 无 法 让 计算 机 自动 判断 软件 行为 是 否 符合 预期 ”， 会 让 程序 员 在 感知 代码 问题 方面 反馈 迟缓 。 


3) “问题 产生 后 没 能 立 


4) “照搬 设计 模式 导致 设计 出 不 必要 的 抽象 和 编写 出 从 未 被 调用 的 方法 ”所 增加 的 无 谓 的 复杂 性 ， 和 “程序 调试 过 程 无 法 让 计算 机 来 蔡 代 并 自动 化 地 反复 使 用 ”， 都 会 让 程序 员 在 维护 代码 质量 方面 反 


馈 迟 缓 。 


即 发 现 ”， 会 让 程序 员 、 测 试 工程 师 和 开发 经 理 等 所 有 与 代码 相关 的 人 在 感知 代码 问题 方面 反馈 迟缓 。 


从 这 个 编程 操练 可 以 看 出 ， 测 试 后 行 的 开发 方法 ， 会 使 我 们 在 理解 代码 行为 、 感 知 代码 问题 和 维护 代码 质量 方面 都 反馈 迟缓 ， 其 后 果 就 是 浪费 所 有 这 些 人 的 时 间 、 精 力 和 金钱 。 


讨论 了 这 些 问题 之 后 ， 咱 们 接 下 来 用 测试 驱动 开发 (Test-Driven Development, TOD?) 这 样 测试 先行 的 方法 再 做 一 遍 这 个 编程 操练 ， 然 后 回 过 头 来 看 看 这 些 问题 是 否 能 够 得 到 解决 。 


在 用 TDD 重 做 这 个 编程 操练 之 前 ， 咱 们 看 看 本 章 都 做 了 哪些 


= 


分 析 代码 行为 并 加 断 点 调试 程序 ， 找 到 了 设计 时 出 现 的 错误 。 


2) 在 细 化 后 的 类 图 上 更 改 这 些 错 误 。 


3) 发 现 并 修复 了 小 时 数 为 负数 的 问题 。 


4) 通过 操练 我 们 学 到 了 以 下 知识 : 


a) 测试 后 行 的 开发 方法 所 表现 出 来 的 问题 包括 : 文档 经 常 与 代码 缺乏 同步 造成 理解 偏差 ， 写 main () 方法 进行 的 测试 无 法 让 计算 机 自动 判断 软件 行为 是 否 符合 预期 导致 效率 低下 ， 问 题 产 生 后 没 能 立 


即 发 现 耽误 修复 时 间 ， 照 搬 设 计 模式 导致 设计 出 不 必要 的 抽象 和 编写 出 从 未 被 调用 的 方法 造成 时 间 浪 费 ， 程 序 调试 过 程 无 法 让 计算 机 来 替代 并 自动 化 地 反复 使 用 导致 代码 维护 时 间 剧 增 。 


b) 用 测试 后 行 的 开发 方法 所 开发 出 来 的 代码 ， 会 使 与 代码 相关 的 所 有 人 ， 在 对 代码 的 行为 理解 、 问 题 感知 和 质量 维护 方面 都 反馈 迟缓 ， 其 后 果 就 是 浪费 这 些 人 的 时 间 、 精 力 和 人 金钱 。 


[I] IDE: Integrated Development Environment， 集 成 开发 环境 。 


[2] AJL: http://en.wikipedia. 


org/wiki/Test. Drive_Development 


第 5 章 ”用 TDD 重 做 编程 操练 题目 


现在 让 我 们 用 TDDIT 开 发 方法 ， 再 重新 做 一 遍 自 关于 酒店 世界 时 钟 的 编程 操练 。 完 成 后 再 和 前 面 的 测试 后 行 的 开发 方法 做 一 个 对 比 。 


"需求 没 变 吧 ? " 


没 变 。 不 过 从 现在 开始 


， 请 不 要 再 说 “需求 ”了 ， 要 说 “产品 特性 ” (Feature) 。 因 为 “需求 ”这 个 字眼 带 有 “强制 、 专 制 和 持久 ”的 内 涵 量 ， 这 和 软件 开发 要 “适应 变化 ”的 特点 不 符 。 想 想 我 们 在 


第 一 个 编程 操练 中 曾 把 需求 都 编 上 号 的 一 个 暗示 是 什么 ? 这 暗示 着 这 些 编 上 号 的 需求 就 不 能 再 改 了 。 如 果 要 改 ， 就 得 走 需求 变更 流程 。 如 果 这 是 一 个 固定 总 价 的 软件 开发 合同 中 的 需求 ， 要 想 实现 这 些 变 


更 ， 或 许 就 意味 着 客户 要 另外 支付 费用 。 这 样 一 来 ， 一 个 不 愿 支付 额外 费用 的 客户 又 如 何 能 适应 软件 开发 的 变化 呢 ? 


相 比 前 面 把 需求 编号 的 做 法 ， 咱 们 现在 不 妨 换 一 种 方式 来 描述 产品 特性 。 即 在 卡片 或 报 事 贴 上 写 User Story (PAra 


， 来 重新 描述 第 一 个 编程 操练 中 的 那个 题目 。 


User Story 可 用 多 种 常用 的 格式 中 来 编写 ， 比 如 ， 使 用 下 面 这 种 最 经 典 的 格式 : 


As a <role>, I want <goal/desire> so that <benefit>. 


翻译 成 中 文 如 下 : 


作为 一 位 < 角色 >， 我 想 < 实现 目标 / 拥有 愿望 > 来 < 获得 收益 >。 


“有 意思 ! 让 我 来 试 着 


作为 一 位 酒店 大 堂 服务 员 ， 


这 种 格式 写 一 下 。” 


我 想 在 大 堂 里 北京 、 伦 敦 、 莫 斯 科 、 悉 尼 和 纽约 这 些 城市 时 钟 不 准时 ， 用 设置 自己 手机 时 间 的 方法 ， 自 动 统一 调整 这 些 城市 时 钟 的 时 间 ， 来 避免 逐一 根据 时 差 调整 这 些 时 钟 的 繁琐 工作 。 


看 起 来 不 错 ， 格 式 是 对 了 。 不 过 这 个 User story 依赖 酒店 大 堂 所 挂 的 时 钟 所 表示 的 城市 。 要 是 酒店 新 增 或 减少 了 城市 时 钟 时 ， 是 不 是 还 要 修改 这 个 User Story 呢 ? 编写 出 来 的 User story 最 好 能 像 一 个 独 
立 [6 的 成 年 人 ， 而 不 要 像 一 个 依赖 家 长 照顾 的 孩子 。 不 妨 改 成 下 面 这 样 : 


作为 一 位 酒店 大 堂 服务 员 ， 


我 想 在 大 堂 的 城市 时 钟 不 准时 ， 用 设置 自己 手机 时 间 的 方法 ， 自 动 统一 调整 这 些 城市 时 钟 的 时 间 ， 来 避免 逐一 根据 时 差 调整 这 些 时 钟 的 繁琐 工作 。 


“ 那 像 有 多 少 城市 时 钟 和 每 个 城市 的 时 差 这 样 的 细节 ， 也 是 需求 ， 啊 ， 不 ， 是 产品 特性 的 一 部 分 呀 。 该 在 哪里 表达 呢 ?“ 


这 些 细节 留 到 后 面 与 客 
上 面 写 上 所 有 细节 。 


户 或 代表 客户 的 产品 专家 沟通 时 再 确定 ， 然 后 把 要 点 写 在 卡片 的 背面 ， 以 做 进一步 沟通 之 用 。 不 过 有 一 点 需要 注意 ，User Story 仅 是 一 个 用 来 进一步 沟通 的 指 路 牌 ， 没 有 必要 在 


“现在 有 了 User Story， 那 么 接 下 来 该 做 什么 呢 ? 既然 咱们 现在 换 成 了 TDD 开 发 ， 是 不 是 要 先 写 测试 呢 ?“ 


在 TDD 开 发 中 ， 测 试 确 
成 的 哪个 功能 ? 


实 要 在 生产 代码 之 前 写 。 刚 刚 写 好 的 User story 就 可 以 指导 咱们 进行 测试 。 不 过 在 写 测试 之 前 ， 咱 们 需要 想 一 想 ， 第 一 个 测试 要 测 什么 ”或 者 说 这 个 测试 要 测试 生产 代码 所 要 完 


“把 前 面 那个 main () 方法 里 所 测试 的 功能 拿 来 写 测试 怎么 样 ?“ 


可 以 是 可 以 ， 不 过 main () 方法 里 一 口气 测试 了 5 个 城市 时 钟 ， 是 不 是 太 多 了 ? 将 来 一 个 城市 时 钟 测 试 失败 时 ， 还 得 打开 这 个 包含 5 个 城市 时 钟 的 测试 来 看 究竟 是 哪个 失败 ， 太 麻烦 了 。 咱 们 不 妨 每 个 测 
试 只 测试 一 个 城市 时 钟 的 时 间 ， 以 便于 定位 错误 。 


目前 已 知 有 北京 、 伦 敦 、 莫 斯 科 、 悉 尼 和 纽约 这 5 个 城市 的 时 钟 ， 这 5 个 城市 与 UTC 时 间 的 时 差分 别 是 +8、0、+4、+10 和 -5， 与 UTC 时 差 为 0 的 伦敦 时 钟 最 简单 ， 所 以 不 妨 先 测试 伦敦 时 钟 ， 即 要 测试 
在 手机 设置 为 北京 时 间 9 点 后 ， 伦 敦 时 钟 会 不 会 被 设置 为 凌晨 1 点 。 


要 测试 这 一 点 ， 首 先 要 有 一 个 伦敦 时 钟 的 对 象 ， 比 如 叫 londonClock。 这 个 对 象 应 该 有 一 个 getTime () 方法 ， 用 来 取出 该 时 钟 的 时 间 ， 然 后 和 期 望 的 1 点 进行 对 比 。 


下 面 就 是 这 第 一 个 测试 的 代码 (CM: Added test the_time_of_clock_London_should_be_1_after_the_phone_clock_is_set_to_9 Beijing time () and wrote an assertion.) : 7] 


public class HotelWorldClocksTest { 

@Test 

public void the time of clock London should be 1 after the phone clock is 
set to 9 Beijing time() { ~ i an 加 0 
// Arrange 
// Bet 
// Assert 
assertEquals (1, londonClock.getTime()); 


“这 个 测试 的 方法 名 可 真 够 长 的 。” 


MW. SAK, AXA SSR TIMES!) (中 文 意思 : 当 手 机 时 钟 被 设置 为 北京 时 间 9 点 后 ， 伦 敦 时 钟 的 时 间 应 该 是 1 点 。) ， 并 且 用 下 划 线 连接 每 个 单词 ， 以 便于 阅读 。 


“这 里 面 的 Arrange、Act 和 Assert 这 3 行 注释 是 什么 意思 ?“ 


这 表示 了 一 个 测试 通常 要 做 的 3 件 事 ， 即 Arrange 是 做 一 些 测试 前 的 准备 工作 ，Act 是 调用 要 测试 的 方法 来 运行 ，Assert 是 判断 上 面 运行 的 结果 是 否 符合 预期 。 


“ 嗯 ， 测 试 一 般 都 按 这 个 顺序 来 做 这 3 件 事 。 不 过 为 什么 要 空 着 前 两 件 事 不 做 


而 先 做 第 3 件 事 ， 即 写 assert 语 句 呢 ? “ 


您 有 没有 听 说 过 “分 形 ”这 个 概念 ? 英文 叫 Fractal。 


“没有 。” 


“分 形 ” 指 的 是 这 样 一 种 曲线 或 图 案 ， 它 包含 了 和 自己 的 形状 完全 相同 的 一 些小 的 曲线 和 图 案 。 就 好 比 人 类 的 父母 生出 的 孩子 都 和 自己 很 像 一 样 。 而 这 种 相似 性 是 不 是 会 产生 一 种 和 谐 的 结果 呢 ? 在 大 
的 测试 驱动 开发 方面 ， 我 们 是 用 测试 来 反 向 驱动 出 生产 代码 的 。 而 在 其 中 小 的 一 个 测试 里 面 ， 我 们 又 用 先 写 Assert 来 反 向 驱动 出 Act 和 Arrange 这 两 步 。 这 是 不 是 体现 出 分 形 的 和 谐 ? 另外 ， 代 码 关键 字 和 语 
句 都 是 英文 ， 如 果 由 此 衍生 出 来 的 代码 中 的 命名 和 注释 也 是 英文 的 话 ， 那 么 是 不 是 也 很 和 谐 ? 


@ 


8, AT. ” 


咱们 先 看 看 这 条 assert 语 句 。assertEquals () 方法 是 org.junit.Assert 类 的 一 个 静态 方法 ， 用 来 判断 两 个 值 是 否 相等 。 这 个 方法 有 两 个 参数 。 第 一 个 参数 是 期 望 值 ， 这 里 是 数值 1， 表 示 这 个 assert 语 句 
期 望 伦敦 时 钟 的 时 间 是 1 点 。 第 二 个 参数 是 londonClock 变 量 的 getTime () 的 返回 值 。 变 量 londonClock 还 未 定义 ， 不 过 能 否 通 过 它 来 看 出 咱们 的 生产 代码 的 接口 设计 呢 ? 


“londonClock 变 量 的 类 型 应 该 是 一 个 类 ， 这 个 类 有 一 个 成 员 方 法 getTime () 。” 


没 错 。 这 样 就 能 从 测试 代码 “驱动 ”出 生产 代码 了 。 这 种 在 变量 定义 前 直接 写 出 使 用 该 变量 的 代码 的 编程 方式 ， 咱 们 已 经 在 前 面 操练 时 用 到 过 了 。 它 还 有 一 个 名 字 一 一 “意图 式 编 


程 ” (Programming by Intention) 9], 


写 完 了 Assert， 咱 们 现在 可 以 接着 写 这 个 测试 的 Act。 如 何 才能 让 londonClock 的 时 间 变 成 1 点 呢 ? 需要 把 手机 时 钟 设置 为 9 点 ， 另 外 手机 时 钟 还 需要 持 有 londonClock， 以 便于 把 手机 时 钟 设 置 为 9 点 


在 HotelWorldClocksTest 类 中 设置 9 点 和 londonClock 的 代码 如 下 所 示 (CM: In the test, asked the phoneClock to hold the londonClock and set the time of the phoneClock to be 9 so 
that the phoneClock could update the time of the londonClock.) : 


+import static org.junit.Assert.assertEquals; 


// Act 
+ phoneClock.setCityClock (londonClock) ; 
+ phoneClock.setTime (9) ; 


接 下 来 该 写 Arrange 了 。 在 前 面 Assert 和 Act 里 面 的 londonClock 和 phoneClock 变 量 ， 在 这 里 都 应 该 被 定义 ， 并 被 初始 化 。 另 外 ， 伦 敦 与 UTC 时 间 的 时 差 是 0， 手 机 所 在 的 北京 时 间 与 UTC 时 间 的 时 差 是 
8， 这 两 个 时 差 值 也 应 该 在 实例 化 CityClock 和 PhoneClock 类 时 ， 作 为 构造 器 的 参数 ， 分 别传 到 这 两 个 实例 中 。 


在 HotelWorldClocksTest 类 中 定义 并 初始 化 londonClock 和 phoneClock 变 量 的 代码 如 下 所 示 (CM: Instantiated a CityClock and a PhoneClock with UTC offset in the test.) : 


// Arrange 
CityClock londonClock = new CityClock (0 
PhoneClock phoneClock = new PhoneClock( 


) 
8); 


++ 


现在 ， 在 这 第 一 个 测试 方法 中 ， 有 7 处 代码 显示 了 编译 错误 的 红色 。 不 要 畏惧 这 些 错误 ， 反 而 应 该 感谢 它们 。 因 为 这 些 错误 就 像 茫茫 大 海中 的 灯塔 ， 为 咱们 继续 前 进 指明 了 方向 。 


“这 块 我 来 做 吧 。 从 上 往 下 一 个 一 个 地 解决 这 些 错误 。 首 先是 CityClock 是 红色 的 ， 表 示 这 个 类 还 未 创建 。 按 Alt+Enter 快 捷 键 来 创建 它 。” 


创建 CityClock 类 的 代码 如 下 所 示 (CM: Created class CityClock.) : 


+public class CityClock { 
+} 


“这 个 类 里 该 写 什么 内 容 呢 ?“ 


先 空 着 它 吧 。 俗 话说 ， 不 见 兔子 不 撒 磨 。 等 后 面 需要 它 的 时 候 再 写 不 迟 。 


“ 接 下 来 再 用 Alt+ Enter 快 捷 键 解决 CityClock 类 缺少 一 个 带 有 参数 的 构造 器 的 错误 。” 


创建 带 有 参数 的 CityClock 类 的 构造 器 代码 如 下 所 示 (CM: Created constructor of CityClock with a UTC offset time as the parameter.) : 


public class CityClock { 
+ public CityClock(int utcOffset) { 


4 
+ 
} 


} 


“下 一 个 要 解决 的 错误 是 PhoneClock 类 未 创建 。 这 里 也 用 Alt+ Enter 快 捷 键 创建 。” 


创建 PhoneClock 类 的 代码 如 下 所 示 (CM: Created class PhoneClock.) : 


+public class PhoneClock { 
+} 


“ 接 下 来 还 是 要 解决 PhoneClock 类 缺少 一 个 带 有 参数 的 构造 器 的 错误 。 用 Alt+Enter 快 捷 键 创建 这 个 构造 器 。” 


创建 带 有 参数 的 PhoneClock 类 的 构造 器 代码 如 下 所 示 (CM: Created constructor of PhoneClock with a UTC offset time as the parameter.) : 


public class PhoneClock { 
H public PhoneClock (int utcOffset) { 
+ 

+ } 

} 


“ 接 下 来 的 错误 是 PhoneClock 类 少 了 一 个 setCityClock () 方法 。 还 是 用 Alt+ Enter 快 捷 键 创建 。” 


在 PhoneClock 类 中 创建 setCityClock () 方法 的 代码 如 下 所 示 (CM: Created method Phone-Clock.setCityClock () .) : 


+ public void setCityClock(CityClock cityClock) { 


++ 


“ 接 下 来 的 错误 是 PhoneClock 类 还 缺少 一 个 setTime () 方法 。” 


在 PhoneClock 类 中 创建 setTime () 方法 的 代码 如 下 所 示 (CM: Created method PhoneClock.setTime () .) : 


public void setTime(int time) { 


十 十 十 十 


} 


“最 后 还 有 一 个 CityClock 类 缺少 getTime () 方法 的 错误 。 用 Alt+ Enter 快 捷 键 补 上 这 个 方法 。” 


能 不 能 让 这 个 方法 返回 一 个 假 数据 ， 好 让 这 个 测试 尽早 通过 呢 ? 


"应 该 可 以 的 。 只 要 返回 1， 测 试 就 肯定 通过 了 。 不 过 这 么 写 代码 不 是 太 烂 了 吗 ?“ 


烂 有 烂 的 好 处 。 头 一 个 好 处 就 是 测试 运行 通过 了 ， 这 样 好 让 咱们 结束 上 一 环节 的 工作 ， 进 入 下 一 环节 的 重 构 。 另 一 个 好 处 就 是 能 让 咱们 看 到 重 构 的 方向 。 先 写 出 这 段 烂 代码 ， 然 后 我 告诉 您 它 怎么 就 指 
出 了 方向 。 


在 类 CityClock 里 创建 getTime () 方法 并 返回 1 的 代码 如 下 所 示 (CM: Created method CityClock.getTime () and made the test green with a fake value.) : 


+ public int getTime() { 
+ return 1; 
+ 


按 Alt+ 1 快捷 键 进入 左 侧 的 Project 工 具 窗口 ， 将 光标 定位 到 HotelWorldClocksTest 类 上 ， 然 后 按 Ctrl+Shift+F10 组 合 键 来 运行 这 个 测试 。 测 试 变 绿 ， 运 行 通过 。 


在 进一步 发 现 重 构 方向 之 前 ， 咱 们 先 看 一 看 本 章 所 做 的 事情 。 


1) 用 User Story 的 格式 ， 重 新 描述 了 产品 特性 。 


2) 根据 User Story 的 描述 ， 从 所 有 待 测 的 城市 时 钟 中 挑选 了 一 个 情况 最 简单 的 城市 时 钟 来 编写 第 一 个 测试 。 


3) 在 编写 生产 代码 之 前 ， 就 在 测试 代码 中 编写 了 符合 自己 意图 的 代码 ， 并 通过 修复 意图 代码 的 编译 错误 来 驱动 生成 了 生产 代码 。 


4) 通过 操练 我 们 学 到 了 以 下 技能 : 


a) 把 以 前 所 提 到 的 带 有 强制 、 专 制 和 持久 色彩 的 “需求 ”一 词 ， 换 成 了 “产品 特性 ”这 样 基 于 沟通 的 字眼 ， 能 够 让 产品 特性 在 频繁 沟通 的 保证 下 更 加 具有 价值 。 


b) 把 测试 方法 的 名 字 写 得 很 长 ， 并 在 单词 之 间 加 上 空格 ， 使 得 测试 方法 名 成 为 易于 阅读 的 文档 。 


c) 一 个 测试 通常 包括 Arrange、Act 和 Assert 这 3 部 分 ， 分 别 表示 测试 准备 、 调 用 待 测 方法 和 验证 结果 是 否 符合 预期 。 


d) 在 一 个 测试 中 先 写 最 后 的 Assert 部 分 ， 然 后 推导 出 Act 和 Arrange 这 两 部 分 代码 ， 会 更 加 符合 TDD 的 测试 驱动 风格 ， 营 造 出 分 形 的 和 谐 气氛 。 


e) 没有 适当 的 面向 对 象 的 设计 ， 就 无 法 写 出 合理 的 意图 代码 。 所 以 在 测试 中 编写 意图 代码 就 能 促进 在 写 测试 代码 时 做 出 适当 的 设计 。 


f) 在 测试 中 写 好 了 所 有 的 意图 代码 后 ， 由 于 生产 代码 还 未 编写 ， 势 必 有 许多 编译 错误 ， 而 这 种 用 修复 意图 代码 编译 错误 的 方法 来 驱动 出 生产 代码 的 做 法 ， 能 够 让 生产 代码 的 开发 过 程 更 加 有 方向 性 。 


g) 在 逐个 解决 上 述 编译 错误 的 过 程 中 ， 只 写 能 让 编译 通过 的 、 尽 量 少 的 代码 ， 比 如 空 类 或 空 方法 ， 而 把 编写 其 具体 实现 的 内 容留 到 后 面 运行 测试 出 错时 再 写 ， 同 样 能 够 让 生产 代码 的 开发 过 程 更 加 有 方 
向 性 ， 且 有 助 于 编写 出 不 多 不 少 并 能 让 测试 运行 通过 的 代码 ， 避 免 了 时 间 的 浪费 。 


h) 用 直接 返回 假 数据 的 方法 ， 让 测试 尽快 运行 通过 ， 这 样 能 够 快速 结束 当前 编写 测试 的 环节 ， 进 入 下 面 的 重 构 环节 ， 并 能 进一步 指出 重 构 的 方向 。 


中 ”由 于 篇 幅 所 限 ， 本 书 所 列 的 代码 只 能 是 一 些 片 段 ， 无 法 随时 看 到 代码 全 貌 。 为 能 够 最 有 效 地 体会 本 书 编程 过 程 中 的 代码 的 变化 ， 请 读者 打开 自己 计算 机 上 的 IDEA， 跟 着 本 书 的 描述 一 步 步 地 输入 代码 并 
运行 ,仔细 体会 ， 必 有 收获 。 


2] ”由 于 篇 幅 所 限 ， 本 书 所 列 的 代码 只 能 是 一 些 片段 ， 无 法 随时 看 到 代码 全 貌 。 为 能 够 最 有 效 地 体会 本 书 编程 过 程 中 的 代码 的 变化 ， 请 读者 打开 自己 计算 机 上 的 IDEA， 跟 着 本 书 的 描述 一 步 步 地 输入 代码 并 
运行 ,仔细 体会 ， 必 有 收获 。 

3] Kent Beck,Cynthia Andres, «Extreme Programming Explained:Embrace Change X , Addison-Wesley,2nd Edition, November 26,2004。 

4] User Story， 是 在 软件 开发 中 所 写 出 的 几 名 文字， 来 用 软件 最 终 用 户 所 习惯 的 语言 描述 该 用 户 的 产品 特性 。 参 见 : http://en.wikipediaorg/wiki/User_story o 

5] AIL: http://en.wikipedia.org/wiki/User_story。 

6] 出 自 编 写 User Story 的 INVEST 口 诀 ， 即 要 把 User Story 编 写成 : 独立 的 (Independent) 、 可 商量 的 (Negotiable) 、 有 价值 的 (Valuable) 、 可 估算 的 (Estimable) 、 合 理 规 模 的 (Sized appropriately) 和 可 测 
áh (Testable) 。 参 见 : http://en.wikipedia.org/wiki/INVEST_(mnemonic)。 

7] 本 章 源 代 码 参 见 以 下 链接 : https://github.com/wubin28/tbc-hotel-world-clocks-test-first。 

8 如 果 团队 成 员 大 多 不 说 英语 ， 可 以 把 测试 方法 的 命名 写成 中 文 。 像 Java 这 样 现代 的 编程 语言 都 支持 中 文 的 代码 命名 。 测 试 一 方面 是 固化 生产 代码 的 行为 的 固化 剂 ， 另 一 方面 也 是 描述 生产 代码 行为 的 文 
档 。 只 要 测试 命名 这 样 的 文档 和 代码 的 行为 能 够 做 到 “知行 合 一 ”， 那 就 达到 目的 了 。 


9] 参见 : http://www.netobjectives.com/resources/programming-intention 


第 6 章 “消除 假 数据 所 带 来 的 重复 代码 


“咱们 用 直接 返回 假 数据 1 这 个 烂 代码 让 测试 运行 通过 了 。 接 下 来 要 做 什么 呢 ?” 


接 下 来 就 要 对 付 这 个 烂 代码 。 您 读 过 Martin Fowler 的 《 重 构 》[1 一 书 吗 ? 知道 最 难 闻 的 代码 “ 腐 臭 ”是 什么 吗 ? 


“ 读 过 。 不 过 熊 节 翻 译 的 中 译本 把 Code smell 翻 译 成 代码 的 坏 味道 。 最 难 闻 的 当 属 重复 代码 。 


很 好 。 我 觉得 由 于 中 西方 观念 的 差异 ， 外 国人 很 在 意 的 坏 味道 ， 在 中 国 这 样 人 口 稠密 的 国家 ， 就 会 不 那么 引信 人 注意。 比如 在 北京 南城 每 天 步行 接送 孩子 上 下 学 的 人 们 ， 对 于 街 上 空气 中 经 常会 有 的 坏 味 
道 早已 司空 见 惯 。 所 以 我 觉得 用 “ 腐 臭 ”这 个 字眼 更 能 引起 我 们 的 重视 。 大 家 都 希望 自己 能 流芳 干 古 ， 而 不 要 “腐烂 发 臭 ”。 


好 了 ， 言 归 正 传 。 在 这 个 返回 假 数据 1 的 代码 中 ， 您 能 闻 到 重复 代码 的 “ 腐 臭 ” 吗 ? 


“ 没 看 到 重复 呀 。” 


再 仔细 看 看 ， 这 个 在 生产 代码 里 直接 返回 的 假 数 据 1， 还 在 哪里 出 现 了 ? 


“ 那 只 能 是 在 测试 代码 中 那个 assert 语 句 中 出 现 了 。“ 


生产 代码 中 直接 返回 假 数据 1 的 代码 如 下 所 示 : 


public class CityClock { 


i public int getTime() { 
return 1; 


} 


测试 代码 中 进行 判断 的 assert 语 句 中 出 现 1 的 代码 如 下 所 示 : 


public class HotelWorldClocksTest { 
@Test 
public void the time of clock London should be 1 after the phone clock is_ 
set to 9 Beijing time() { 


// Assert 
assertEquals (1, londonClock.getTime()); 
} 


对 。 在 生产 代码 与 测试 代码 之 中 所 出 现 的 重复 代码 也 必须 去 除 。 刚 才 说 过 ， 烂 代码 能 给 咱们 指出 重 构 的 方向 。 那 么 这 种 重复 ， 就 是 一 个 要 重 构 的 方向 。 


“明白 了 。 另 外 我 还 观察 到 ，CityClock 和 PhoneClock 这 两 个 类 ， 都 有 一 个 以 UTC 时 差 utcOffset 作 为 参数 的 构造 器 。 这 个 参数 传 进 构造 器 后 ， 都 会 保存 在 各 自 的 类 的 成 员 变量 里 。 这 样 一 来 ， 这 两 个 相 
同类 型 和 用 途 的 成 员 变 量 之 间 也 出 现 了 重复 。” 


没 错 。 将 来 咱们 可 以 在 这 两 个 类 之 上 ， 表 提取 一 个 父 类 ， 然 后 把 这 两 个 类 中 的 utcOffset 成 员 变 量 都 移动 到 父 类 中 ， 这 样 就 能 消除 重复 。 除 此 之 外 ， 对 现在 的 代码 咱们 还 有 什么 可 以 进一步 做 的 任务 吗 ? 


“目前 的 测试 仅仅 测试 了 设置 手机 时 钟 后 ， 伦 敦 这 一 个 城市 的 时 钟 的 调整 情况 ， 还 没有 测试 同时 调整 多 个 城市 时 钟 的 情况 。” 


对 。 另 外 ， 咱 们 的 测试 目前 只 考虑 了 比 UTC 时 间 早 的 城市 ， 还 没有 考虑 比 UTC 时 间 晚 的 城市 ， 比 如 纽约 ， 后 者 可 能 会 出 现时 间 是 负数 的 情况 。 


饭 要 一 口 一 口 地 吃 ， 目 前 咱们 发 现 的 这 4 个 任务 ， 也 要 一 个 一 个 地 做 。 俗 话说 : 好 脑子 不 如 烂 笔头 。 为 了 防止 咱们 在 做 的 过 程 中 忘记 哪个 任务 ， 先 把 这 4 个 任务 ， 在 代码 中 相关 的 位 置 上 ,都 一 一 写 上 
TODO 注 释 。 这 样 一 来 ， 咱 们 只 要 按 Alt+ 6 快捷 键 ， 再 按 Ctrl+ + 四 快捷 键 展开 所 有 的 TODO， 就 能 方便 地 调 出 来 查看 。 这 4 个 任务 中 ， 消 除 假 数据 1 那个 重复 代码 可 以 先 做 ， 所 以 把 它 写成 TODO-working- 
on， 表 示 咱 们 正在 解决 这 个 任务 。 


按 Alt+ 6 快捷 键 后 ， 这 4 个 TODO 任 务 显示 在 IDEA 界 面 底部 ， 如 


6-1 所 示 。 


[ 


“该 如 何 消 除 假 数 据 1 这 个 重复 代码 的 “ 腐 臭 ” 呢 ?“ 


这 个 假 数据 1 在 测试 和 生产 代码 中 各 出 现 一 次 。 在 测试 代码 中 咱们 没 法 把 它 变 成 变量 的 形式 ， 但 在 生产 代码 中 ， 咱 们 是 可 以 把 它 转变 成 变量 的 形式 的 。 想 想 看 ， 在 CityClock 类 中 的 getTime () 方法 
里 ， 哪 些 变量 运算 后 能 得 到 这 个 数值 1 呢 ? 
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图 6-1 IDEA 界 面 底部 显示 4 个 TODO 任 务 
“这 个 数值 1 其 实 表示 的 就 是 伦敦 的 当地 时 间 凌 晨 1 点 。 这 个 当地 时 间 可 以 用 UTC 时 间 与 该 城市 与 UTC 时 间 的 时 差 相 加 得 到 。 也 就 是 说 : 当地 时 间 =UTC 时 间 + 当 地 时 间 与 UTC 时 间 的 时 差 。” 


没 错 。 在 CityClock 类 中 的 getTime () PAE, MEZ 
CityClock.getTime () .) : 


居 1 用 两 个 变量 之 和 来 替代 的 代码 如 下 所 示 (CM: Replaced the fake value with the intention code in method 


public int getTime() { 
/ 


/ TODO-working-on: The fake value in the production code and the expected 


value in the test code are duplicated 
= return 1; 
+ return this.utcOffset + this.utcZeroTime; 


这 里 ， 上 面 两 个 变量 之 和 ， 就 是 咱们 的 意图 代码 。 其 中 ，this.utcOffset 表 示 当 地 时 间 与 UTC 时 间 的 时 差 ，this.utcZeroTime 表 示 UTC 时 间 。 


“现在 这 行 意图 代码 中 又 出 现 了 两 个 红色 的 编译 错误 ， 表 示 这 两 个 成 员 变 量 尚未 定义 。 让 我 来 一 个 一 个 地 用 Alt+Enter 快 捷 键 来 对 付 它们 吧 。” 


先 对 付 utcOffset。 在 类 CityClock 中 创建 utcOffset 成 员 变 量 并 在 该 类 构造 器 中 将 其 赋值 的 代码 如 下 所 示 


constructor.) : 


CM: Created field utcOffset in class CityClock and assigned a value to it in the 


Be class CityClock { 
private int utcOffset; 
H 


// TODO: The constructors of CityClock and PhoneClock are duplicated 


public CityClock (int utcOffset) { 


+ this.utcOffset = utcOffset; 
} 


再 对 付 utcZeroTime。 在 类 CityClock 中 创建 utcZeroTime 成 员 变 量 的 代码 如 下 所 示 (CM: Created field utcZeroTime in class CityClock.) : 


public class CityClock { 
private int utcOffset; 
+ private int utcZeroTime; 


“这 个 CityClock 类 的 utcZeroTime 成 员 变量 ， 该 由 谁 给 它 赋 值 呢 ?“ 


应 该 可 以 由 PhoneClock 这 个 手机 时 钟 类 ， 在 它 调用 setTime () AAR, tH 


值 。 为 了 能 做 到 这 一 点 ， 我 希望 在 PhoneClock 类 里 面 ， 能 有 一 个 类 型 为 CityClock 类 的 成 员 变 量 cityClock。 而 且 我 希望 能 够 调 


员 变 量 赋值 。 


在 PhoneClock 类 中 的 setTime () 方法 中 为 该 类 所 持 有 的 CityClock 实 例 设置 UTC 时 间 的 意图 


居 传 入 的 当地 时 间 和 手机 时 钟 的 UTC 时 差 ， 来 计算 出 UTC 时 间 ， 并 给 它 所 持 有 的 CityClock 对 象 的 utcZeroTime 成 员 变 量 赋 
CityClock 类 的 setUtcZeroTime () 方法 ， 来 为 cityClock 的 utcZeroTime 成 


代码 如 下 所 示 (CM: Wrote intention code in method PhoneClock.setTime () .) : 


public void setTime(int time) { 


+ this.cityClock.setUtcZeroTime (time ~ this.utcOffset) ; 


} 


“兔子 来 了 ， 严 阵 以 待 的 setTime () 方法 终于 该 撒 出 去 了 。 " 


哈哈 ， 对 。 


“现在 又 可 以 沿 着 意图 代码 中 的 红色 编译 错误 的 指引 来 编程 了 。” 


没 错 。 上 面 这 条 语句 中 的 this.cityClock 有 编译 错误 ， 表 示 PhoneClock 类 缺少 一 个 名 为 cityClock 的 成 员 变 量 。 现 在 就 创建 它 。 另 外 ， 它 应 该 在 该 类 的 那个 空 的 setCityClock () 方法 里 被 赋值 。 又 盯 上 


一 只 "ATF o 


在 PhoneClock 类 中 创建 cityClock 成 员 变量 并 赋值 的 代码 如 下 所 示 (CM: Created field cityClock and assigned a value to it in class PhoneClock.) : 


public class PhoneClock { 
+ private CityClock cityClock; 
+ 


public void setCityClock (CityClock cityClock) { 


+ 


this.cityClock = cityClock; 
} 


接 下 来 再 处 理 前 面 那 行 意图 代码 中 最 后 的 部 分 this.utcOffset 的 编译 错误 。 这 个 错误 也 是 由 于 PhoneClock 类 还 未 创建 utcOffset 这 个 成 员 变量 而 造成 的 。 现 在 就 创建 它 。 另 外 ， 这 个 成 员 变量 应 该 在 
PhoneClock 类 的 构造 器 中 被 赋值 。 


在 PhoneClock 类 中 创建 utcOffset 成 员 变 量 并 赋值 的 代码 如 下 所 示 (CM: Created field utcOffset and assigned a value to it in class PhoneClock.) : 


public class PhoneClock { 

private CityClock cityClock; 
+ private int utcOffset; 

public PhoneClock(int utcOffset) { 
+ this.utcOffset = utcOffset; 

} 


最 后 处 理 前 面 那 条 意图 代码 中 最 后 一 个 编译 错误 : CityClock 类 还 未 创建 setUtcZeroTime () 方法 。 先 把 光标 定位 到 这 个 错误 上 ， 然 后 用 Alt+ Enter 快 捷 键 创建 该 方法 ， 并 在 这 个 方法 里 将 参数 
utcZeroTime 赋 值 给 CityClock 类 的 成 员 变 量 。 


在 CityClock 类 中 创建 setUtcZeroTime () 方法 并 将 其 参数 utcZeroTime 赋 值 给 该 类 的 成 员 变 量 的 代码 如 下 所 示 (CM: Created method CityClock.setUtcZeroTime () and assigned the UTC 
zero time to the field of class CityClock.) : 


public class CityClock { 


public void setUtcZeroTime(int utcZeroTime) { 
this.utcZeroTime = utcZeroTime; 


+++ +i 


} 


好 了 ， 所 有 的 错误 都 修复 了 。 看 起 来 应 该 可 以 运行 测试 了 。 因 为 前 面 已 经 运行 过 测试 了 ， 所 以 咱们 只 要 按 Ctrl+F5 快 捷 键 ， 就 能 重新 运行 测试 。 


按 一 下 试 试 ， 测 试 运行 通过 。 


当 
Ht 
| 


以 把 那个 解决 假 数据 1 的 TODO 删 掉 。 按 Alt+6 和 Ctrl+ + 快捷 键 看 一 眼 剩 下 的 TODO， 并 从 中 挑选 下 一 个 要 处 理 的 任务 。 


在 挑选 下 一 个 TODO 之 前 ， 咱 们 先 看 看 本 章 都 做 了 什么 工作 : 


1) 在 用 假 数 据 让 测试 快速 通过 的 情况 下 ， 找 到 了 在 测试 代码 和 生产 代码 之 间 存 在 重复 代码 的 “ 腐 臭 ”， 并 在 生产 代码 中 用 变量 来 替换 假 数 据 的 方法 来 消除 重复 代码 。 


2) 把 当时 所 有 发 现 的 代码 “ 腐 臭 ”和 要 继续 做 的 任务 都 以 添加 TODO 注 释 的 方式 ， 写 在 代码 相应 位 置 ， 并 方便 地 用 快捷 键 调 出 查看 ， 用 来 备 忘 并 从 中 寻找 下 一 个 要 处 理 的 任务 。 


3) 把 当前 正在 处 理 的 TODO 标 记 成 TODO-working-on， 以 该 TODO 为 导向 ， 继 续 使 


IR] 


式 编程 的 方法 ， 循 着 意图 代码 中 的 红色 编译 错误 的 指引 ， 驱 动 出 生产 代码 。 


4) 通过 操练 我 们 学 到 了 : 把 在 编程 中 随时 发 现 的 要 处 理 的 问题 ， 在 代码 中 相应 的 位 置 写 成 TODO， 并 在 将 来 使 用 快捷 键 Alt+ 6 来 查看 ， 能 让 随时 发 现 的 问题 不 致 中 断 现 有 的 工作 ， 并 且 不 会 遗忘 任何 发 
现 要 做 的 事情 。 


[1] Martin Fowler 著 ， 能 节 译 。《 重 构 : 改善 既 有 代码 的 设计 》， 人 民 邮 电 出 版 社 ，2010 年 4 月 第 1 版 
[2] Ced++ 表 示 先 按 Cttl 键 并 保持 住 ， 然 后 按键 盘 上 的 加 号 键 。 


第 7 章 ”让 下 一 个 测试 足够 有 意思 


“咱们 已 经 测 完 情况 最 简单 的 伦敦 时 钟 的 时 间 调 整 了 。 接 下 来 还 有 北京 、 莫 斯 科 、 悉 尼 和 纽约 这 4 个 城市 时 钟 。 反 正 现在 城市 时 钟 也 不 多 ， 要 不 要 一 个 接 一 个 地 把 它们 都 测 一 遍 呢 ?“ 


是 这 剩 下 的 4 个 城市 时 钟 所 属 的 测试 等 价 类 [都 各 不 相同 ， 且 与 已 经 测 过 的 伦敦 时 钟 的 测试 等 价 类 也 不 相同 ， 那 么 可 以 把 它们 一 个 一 个 地 都 测 一 遍 。 但 在 此 之 前 ， 咱 们 首先 要 划分 一 下 测试 等 价 类 。 


如 果 把 城市 当地 时 间 与 UTC 时 间 的 时 差 作为 划分 等 价 类 的 标准 ， 那 么 就 可 以 划分 为 3 类 城市 时 钟 : 一 类 是 当地 时 间 比 UTC 时 间 早 的 城市 ， 比 如 北京 、 莫 斯 科 和 悉尼 ; 一 类 是 当地 时 间 比 UTC 时 间 晚 的 城 
市 ， 比 如 纽约 ; 最 后 一 类 是 当地 时 间 与 UTC 时 间 相 同 的 城市 ， 比 如 伦敦 。 


现在 最 后 一 个 等 价 类 的 代表 城市 伦敦 的 时 钟 已 经 测 过 了 。 下 一 个 测试 就 可 以 从 另外 两 个 等 价 类 中 选 一 个 城市 来 测试 。 


“ 选 北京 时 钟 如 何 ? 它 的 时 间 应 该 和 手机 设置 的 时 间 保 持 一 致 ， 足 够 简单 。” 


看 起 来 不 错 。 但 是 我 觉得 这 样 做 没有 意思 。 因 为 现 有 处 理 伦敦 时 钟 这 种 当地 时 间 与 UTC 时 差 为 0 的 代码 应 该 也 能 够 适用 于 北京 时 钟 这 样 UTC 时 差 为 正 整 数 的 情况 。 换 名 话说， 如 果 咱 们 现在 增加 一 个 针对 
北京 时 钟 的 测试 ， 那 么 这 个 测试 在 不 修改 任何 生产 代码 的 情况 下 就 能 运行 通过 。 这 不 够 有 意思 。 


而 如 果 选 第 二 个 等 价 类 的 代表 纽约 时 钟 来 作为 下 一 个 测试 ， 那 么 根据 目前 的 代码 行为 ， 这 种 情况 所 得 到 的 时 间 就 会 是 负数 ， 即 Negative hour 这 个 TODO 任 务 所 描述 的 情况 。 这 会 驱动 咱们 重 构 生产 代 
码 ， 从 而 使 这 个 测试 运行 通过 。 这 就 有 意思 得 多 了 。 


"8, MEAS. ” 


接 下 来 可 以 开始 做 这 个 Negative hour 的 TODO 任 务 了 。 先 把 它 改 成 TODO-working-on。 


现在 的 TODO 列 表 如 图 7-1 所 示 。 


¥ Found 3 TODO items in 2 files 
w © tbc.tdd.hotelworldclocks (3 items in 2 files) 
y © CityClock.java 
E (10, 8) / TODO: The constructors of CityClock and PhoneClock are duplicated 


y @ HotelWorldClocksTest.java 
E (25, 8) // TODO-working-on: Negative hour 
E (26, 8) / TODO: Set time to multiple city clocks 


图 7-1 Negative hour TODO 任 务 


在 测试 类 中 为 Negative hour 这 个 TODO 任 务 添加 一 个 测试 方法 的 代码 如 下 (CM: Added test 


the time of clock NewYork should be 20 after the phone clock is set to 9 Beijing time () and got a negative hour in the actual result.) : 


public class HotelWorldClocksTest { 

ie // TODO-working-on: Negative hour 

+ @Test 

+ public void the time of clock NewYork should be 20 after_the_phone_clock_ 
is set to 9 Beijing time() { 


+ // Arrange 

+ CityClock newYorkClock = new CityClock(-5); 
+ PhoneClock phoneClock = new PhoneClock (8) ; 
+ 

+ // Bot 

+ phoneClock.setCityClock (newYorkClock) ; 

+ phoneClock.setTime (9) ; 

+ 

+ // Assert 

+ assertEquals (20, newYorkClock.getTime()); 
+ } 


java.lang.AssertionError: 
Expected :20 
Actual 274 


“时 间 是 负数 的 情况 出 现 了 。 这 是 因为 咱们 目前 是 用 正 整数 来 表示 时 间 ， 还 没有 处 理 时 间 是 负数 的 情况 。” 


由 于 最 后 是 调用 assert 语 句 中 的 newYorkClock.getTime () 方法 来 获得 那个 负数 时 间 的 ， 所 以 咱们 需要 修改 CityClock 类 的 getTime () 方法 。 咱 们 只 要 把 这 个 方法 中 计算 出 来 的 时 间 结 果 ， 加 上 24， 
再 与 24 取 模 ， 就 能 让 表示 时 间 的 整数 保持 在 24 之 内 。 


修改 CityClock 类 的 getTime () 方法 来 把 表示 时 间 的 整数 保持 在 24 之 内 ， 代 码 如 下 (CM: Updated method CityClock.getTime () to make the hour within 24.) : 


public class CityClock { 

E public int getTime() { 

= return this.utcOffset + this.utcZeroTime; 

+ return (this.utcOffset + this.utcZeroTime + 24) % 24; 


再 按 Ctrl+F5 快 捷 键 运行 下 测试 ， 运 行 通过 ! 


咱们 可 以 按 Alt+ 6 快捷 键 调 出 TODO 列 表 看 一 下 。 现 在 可 以 把 Negative hour 这 个 TODO 删 掉 了 。 还 剩 下 两 个 TODO， 一 个 是 CityClock 和 PhoneClock 这 两 个 类 的 构造 器 有 重复 ， 另 一 个 是 一 次 调整 多 个 
城市 时 钟 。 


“后 面 那个 一 次 调整 多 个 城市 时 钟 的 TODO 看 起 来 更 有 意思 一 些 ， 咱 们 可 以 先 处 理 它 。” 
好 的 。 把 它 的 TODO 改 成 TODO-working-on。 


现在 的 TODO 列 表 如 图 7-2 所 示 。 


v Found 2 TODO items in 2 files 
y Ò tbc.tdd.hotelworldclocks (2 items in 2 files) 
了 © CityClock.java 


Æ (10, 8) // TODO: The constructors of CityClock and PhoneClock are duplicated 
y @ HotelWorldClocksTest.java 
=) (39, 8) // TODO-working-on: Set time to multiple city docks 


图 7-2 一 次 调整 多 个 城市 时 钟 的 TODO 


“怎样 测 一 次 调整 多 个 城市 时 钟 呢 ?” 


上 述 测 试 和 其 中 两 个 断言 的 代码 如 下 (CM: Added test the_time_of_clock_London_and_NewYork_should_be_1_and_20 respectively after the_phone clock is set to 9 Beijing time () and 


wrote 2 assertions.) : 


public class HotelWorldClocksTest { 
// TODO-working-on: Set time to multiple city clocks 
+ @Test 


十 十 十 十 十 十 


public void the time of clock London and NewYork should be 1 and 20_ 


respectively : after the phone í clock : is: set_ to 9 Beijing i time() { 


// Assert 
assertEquals (1, londonClock.getTime()); 
assertEquals (20, newYorkClock.getTime ()); 


写 好 这 两 个 断言 后 ， 咱 们 得 思考 一 下 ， 该 用 什么 方法 让 手机 时 钟 能 够 接受 多 个 城市 时 钟 ， 来 一 并 调整 它们 的 时 间 ? 


“咱们 可 以 把 多 个 城市 时 钟 对象 保 存 到 一 个 ArrayList 中 ， 然 后 传 给 PhoneClock 手 机 时 钟 对 象 就 可 以 了 。” 


这 确实 是 一 个 最 简单 的 做 法 。 不 过 我 有 一 个 问题 ， 这 个 ArrayList 类 对 应 业务 领域 中 的 哪个 领域 类 呢 ? 我 们 不 大 可 能 让 一 个 不 懂 Java 的 酒店 大 堂 服务 员 ，F 


不 妨 创 建 一 个 


己 的 手机 去 和 一 个 ArrayList 类 打交道 。 咱 们 


“酒店 世界 时 钟 系统 ” (HotelWorldClockSystem) 领域 类 来 封装 这 个 ArrayList 类 。 这 样 ， 咱 们 就 可 以 把 多 个 城市 时 钟 添加 到 HotelWorld-ClockSystem 类 的 一 个 对 象 中 ， 然 后 把 这 个 对 象 传 
递 给 上 述 PhoneClock 手 机 对 象 ， 这 样 会 更 加 自然 。 


咱们 已 经 写 完了 这 个 测试 的 Assert 的 意 


这 个 方法 调 


而 要 让 手机 时 钟 去 统一 更 新 多 个 城市 时 钟 的 时 间 ， 必 须 把 包含 多 个 城市 时 钟 的 对 象 hotelWorldClockSystem 传 递 给 它 ， 所 以 可 以 写 出 这 
.setHotelWorldClockSystem (hotelWorldClockSystem) 。 这 样 Act 就 写 好 了 。 


phoneCloc 


代码 ， 接 下 来 就 可 以 从 Assert 来 推导 出 Act 的 意 


[ 
[ 


代码 。 要 调整 伦敦 和 纽约 的 时 钟 时 间 ， 必 须 把 对 


机 时 钟 设 置 为 9 点 ， 所 以 可 以 写 出 phoneClock.setTime (9) 


样 的 方法 调用 : 


“让 我 试 试 从 Act 推 导出 Arrange 的 意图 代码 吧 。Act 里 的 phoneClock 对 象 需要 实例 化 出 来 ，hotelWorldClockSystem 对 象 也 需要 实例 化 出 来 。 而 londonClock 和 newYorkClock 这 两 个 城市 时 钟 的 对 


象 也 需要 添加 到 hotelWorldClockSystem 对 象 中 ， 这 样 HotelWorldClockSystem 类 就 需要 有 一 个 attach () 方法 。londonClock 和 newYorkClock 这 两 个 城 


从 Assert 推 导出 Act， 进 而 再 推导 出 Arrange 的 意图 代码 如 下 (CM: Wrote intention code in test 


the time of clock London and NewYork should be 1 and 20 respectively after the phone clock is set to 9 Beijing time 


@Test 
public void the time of clock London and NewYork should be 1 and 20_ 


十 十 十 十 十 十 十 十 十 十 十 


respectively : after 1 the > phone < clock ; is: set_ to 9 Beijing i time() { 

// Arrange 

CityClock londonClock = new CityClock(0); 

CityClock newYorkClock = new CityClock(-5); 

HotelWorldClockSystem hotelWorldClockSystem = new HotelWorldClockSystem () ; 
hotelWorldClockSystem. attach (londonClock) ; 

hotelWorldClockSystem. attach (newYorkClock) ; 

PhoneClock phoneClock = new PhoneClock (8) ; 


// Bot 

phoneClock. setHotelWorldClockSystem (hotelWorldClockSystem) ; 
phoneClock.setTime (9) ; 

// Assert 

assertEquals (1, londonClock.getTime()); 

assertEquals (20, newYorkClock.getTime()); 


下 面 的 工作 就 是 循 着 上 面 这 些 意图 代码 中 的 红色 编译 错误 ， 来 开始 写 最 少量 的 程序 ， 以 使 编译 通过 。 


“ 先 创建 HotelWorldClockSystem 类 。” 


创建 HotelWorldClocksystem 类 的 代码 如 下 (CM: Created class HotelWorldClockSystem.) : 


+public class HotelWorldClockSystem { 


+} 


“再 在 这 个 


类 中 创建 attach () 方法 。” 


() .) : 


在 HotelWorldClockSystem 类 中 创建 attach () 方法 的 代码 如 下 (CM: Created method Hotel-WorldClockSystem.attach () .) : 


public class HotelWorldClockSystem { 
+ public void attach (CityClock cityClock) { 


+ 
+ } 
} 


“PhoneClock 类 中 还 少 一 个 setHotelWorldClockSystem () 方法 。” 


在 PhoneClock 类 中 创建 setHotelWorldClockSystem () 方法 的 代码 如 下 (CM: Created method PhoneClock.setHotelWorldClockSystem () .) : 


public class PhoneClock { 


二 十 十 十 ， 


} 


public void setHotelWorldClockSystem(HotelWorldClockSystem hotelWorldClockSystem) { 


“现在 编译 错误 没有 了 。 咱们 不 妨 按 Ctrl+ F5 快 捷 键 运行 一 下 测试 。 哦 ，PhoneClockJjava 文 件 中 第 19 行 有 一 个 空 指针 的 错误 。 


运行 测试 


后 出 现 的 空 指针 错误 信息 如 下 : 


java.lang.NullPointerException 
at tbc.tdd.hotelworldclocks.PhoneClock.setTime (PhoneClock.java:19) 
at tbc.tdd.hotelworldclocks .HotelWorldClocksTest.the_time_of_clock_London_ 
and_NewYork_should_be_1_and_20_respectively i after the} > phone < clock ; is. 


set to 9 Beijing | time (HotelWorldClocksTest .java:52) 


PhoneClock.java 文 件 的 第 19 行 如 下 : 


this.cityClock.setUtcZeroTime (time - this.utcOffset) ; 


这 一 行 是 在 PhoneClock 类 的 setTime () 方法 中 调用 该 类 的 cityClock 成 员 变 量 的 setUtc-ZeroTime () 方法 来 设置 UTC 时 间 。 由 
HotelWorldClockSsystem 的 对 象 来 保存 多 个 城市 时 钟 ， 而 没有 像 以 前 那样 为 PhoneClock 类 的 cityClock 成 员 变量 赋值 来 单独 设置 一 个 : 


于 咱们 在 这 个 


时钟 的 对 象 也 需要 分 别 实例 化 。” 


调整 多 个 城 


时钟 的 测试 中 使 用 了 新 创建 的 


城市 时 钟 ， 所 以 cityClock 成 员 变量 就 会 是 空 指针 。 


“因为 现在 使 用 HotelWorldClocksystem 的 对 象 来 保存 多 个 城市 时 钟 ， 而 对 于 一 个 城市 时 钟 ， 咱 们 也 可 以 用 这 个 对 象 来 保存 ， 所 以 在 PhoneClock 类 的 setTime () 方法 中 就 可 以 
HotelWorldClocksystem 对 象 的 实现 来 蔡 代 原先 的 cityClock 成 员 变量 的 实现 。 可 以 根据 这 一 点 写 出 意图 代码 。“ 


在 PhoneClock 类 的 setTime () 方法 中 ， 用 HotelWorldClocksystem 对 象 的 实现 蔡 代 原先 的 cityClock 成 员 变 量 的 实现 ， 把 UTC 时 间 设 置 给 所 有 保存 在 该 对 象 中 的 城市 时 钟 的 意图 代码 如 下 (CM: 
Updated method PhoneClock.setTime () to use the clock list stored in the HotelWorldClockSystem.) : 


public class PhoneClock { 


public void setTime(int time) { 
this.cityClock.setUtcZeroTime (time - this.utcOffset) ; 
for (CityClock cityClock : this.hotelWorldClockSystem.getClocks()) { 
cityClock.setUtcZeroTime (time - this.utcOffset) ; 
} 


十 十 十 1 


在 这 个 意图 代码 中 ，PhoneClock 类 的 hotelWorldClockSystem 这 个 成 员 变 量 尚未 定义 。 这 就 定义 它 。 另 外 ， 它 也 应 该 在 该 类 的 setHotelWorldClockSystem () 方法 中 被 赋值 。 


在 PhoneClock 类 中 定义 hotelWorldClocksystem 成 员 变 量 并 对 其 赋值 的 代码 如 下 (CM: The field hotelWorldClockSystem of class PhoneClock was assigned in method 
PhoneClock.setHotelWorldClockSystem () .) : 


public class PhoneClock { 
+ private HotelWorldClockSystem hotelWorldClockSystem; 
ia public void setHotelWorldClockSystem(HotelWorldClockSystem hotelWorldClockSystem) { 


+ this.hotelWorldClockSystem = hotelWorldClockSystem; 


现在 ， 在 PhoneClock 类 的 setTime () FIA, getClocks () 方法 是 红色 的 ， 这 表示 还 未 创建 HotelWorldClockSsystem 类 的 getClocks () 方法 。 按 Alt+Enter 快 捷 键 来 创建 它 。 这 个 方法 返回 该 类 的 
成 员 变量 this.cityClocks。 


创建 HotelWorldClocksystem 类 的 getClocks () 方法 并 返回 成 员 变量 this.cityClocks 的 意图 代码 如 下 (CM: Created method HotelWorldClockSystem.getClocks () to return a clock list stored 
in this class.) : 


+import java.util.ArrayList; 


public class HotelWorldClockSystem { 


public ArrayList<CityClock> getClocks() { 
return this.cityClocks; 


+++ 4) 


} 


在 上 面 这 段 意图 代码 中 ，this.cityClocks 是 红色 的 ， 表 示 HotelWorldClockSystem 类 还 未 创建 cityClocks 成 员 变量 。 按 Alt+ Enter 快 捷 键 来 创建 它 ， 并 赋 初 值 将 其 初始 化 。 


在 HotelWorldClockSsystem 类 中 创建 cityClocks 成 员 变量 并 初始 化 的 代码 如 下 (CM: Created and initialized field cityClocks in class HotelWorldClockSystem.) : 


public class HotelWorldClockSystem { 
+ private ArrayList<CityClock> cityClocks = new ArrayList<CityClock>(); 
+ 


HotelWorldClockSystem 类 的 cityClocks 成 员 变 量 虽 然 已 经 初始 化 了 ， 但 是 为 它 添加 城市 时 钟 的 attach () 方法 还 是 空 的 。 咱 们 现在 可 以 实现 这 个 attach () 方法 。 


“不 等 到 真正 需要 这 个 attach () 方法 时 再 实现 它 吗 ? ” 


哦 ， 我 明白 您 的 意思 。 咱 们 是 可 以 把 这 个 方法 的 实现 放 到 后 面 运行 测试 发 现 与 之 相关 的 错误 时 再 来 处 理 。 不 过 我 个 人 感觉 咱们 对 这 个 多 城市 时 钟 的 测试 已 经 接近 尾声 ， 前 景 已 经 明朗 ， 信 心 已 经 越 来 越 
足 ， 所 以 我 想 步 子 可 以 大 一 些 。TDD 虽 然 讲 究 用 尽量 小 的 步子 来 开发 ， 但 如 果 您 很 有 信心 ， 不 妨 步 子 大 一 些 。 等 到 处 理 更 复杂 的 问题 时 再 换 成 小 步子 也 不 迟 。 宋 代 抗 金 名 将 岳飞 对 于 用 兵 曾 这 样 说 过 : 
之 妙 ， 存 乎 一心 。”TDD 开 发 也 是 如 此 。 它 不 是 死板 的 教条 ， 而 是 可 以 灵活 调整 的 方法 。 


“ 运 


在 HotelWorldClockSystem 类 中 实现 方法 attach () 的 代码 如 下 (CM: Updated method Hotel-WorldClockSystem.attach () to attach a CityClock.) : 


public class HotelWorldClockSystem { 


public void attach (CityClock cityClock) { 


+1 


this.cityClocks.add(cityClock) ; 


现在 编译 没有 错误 了 。 运 行 一 下 测试 看 看 有 什么 问题 。 出 现 两 个 空 指针 错误 : 


java.lang.NullPointerException 
at tbc.tdd.hotelworldclocks.PhoneClock.setTime (PhoneClock.java:20) 
at tbc.tdd.hotelworldclocks .HotelWorldClocksTest.the_time_of_clock_London_ 
should be 1 after the phone clock is set to 9 Beijing 
time (HotelWorldClocksTest.java:19) ~ 7 77 > 
java. lang.NullPointerException 
at tbc.tdd.hotelworldclocks.PhoneClock.setTime (PhoneClock.java:20) 
at tbc.tdd.hotelworldclocks .HotelWorldClocksTest.the_time_of_clock_NewYork_ 
should be 20 after_the_phone_clock_is set to 9 Beijing_ 
time (HotelWorldClocksTest. java: 33) 


这 两 个 空 指针 错误 都 是 原 有 那 两 个 针对 单个 城市 时 钟 的 测试 引发 的 。 其 中 的 原因 咱们 在 前 面 也 提 到 过 : 现在 是 使 用 HotelWorldClockSystem 对 象 来 保存 多 个 城市 时 钟 ， 而 对 于 一 个 城市 时 钟 ， 咱 们 也 可 
以 用 这 个 对 象 来 保存 。 但 原 有 这 两 个 测试 还 没有 改 用 新 的 HotelWorldClockSystem 对 象 来 保存 单个 城市 时 钟 ， 所 以 会 出 现 空 指针 。 现 在 就 改 。 


原 有 两 个 针对 单个 城市 时 钟 的 测试 改 用 新 的 HotelWorldClockSsystem 对 象 来 保存 单个 城市 时 钟 ， 代 码 如 下 (CM: Updated the previous 2 tests to use the new interface HotelWorld- 
ClockSystem.) : 


public class HotelWorldClocksTest { 
public void the time of clock London should be 1 after the phone clock is_ 
set to 9 Beijing time() { 
// Arrange 
CityClock londonClock = new CityClock (0); 


HotelWorldClockSystem hotelWorldClockSystem = new HotelWorldClockSystem() ; 
hotelWorldClockSystem. attach (londonClock) ; 

PhoneClock phoneClock = new PhoneClock (8) ; 

// Bot 

= phoneClock.setCityClock (londonClock) ; 

+ phoneClock. setHotelWorldClockSystem (hotelWorldClockSystem) ; 
phoneClock.setTime (9) ; 


++ 


public void the time of clock NewYork should be 20 after the phone clock_ 
is set to 9 Beijing time() { 
// Arrange — T 
CityClock newYorkClock = new CityClock(-5); 
HotelWorldClockSystem hotelWorldClockSystem = new HotelWorldClockSystem() ; 
hotelWorldClockSystem. attach (newYorkClock) ; 
PhoneClock phoneClock = new PhoneClock (8) ; 
// Bot 
一 phoneClock.setCityClock (newYorkClock) ; 
+ phoneClock.setHotelWorldClockSystem (hotelWorldClockSystem) ; 
phoneClock.setTime (9) ; 


++ 


改 完 这 两 个 测试 ， 再 按 Ctrl+F5 快 捷 键 运行 测试 ，3 个 测试 都 运行 通过 。 
“这 个 处 理 多 个 城市 时 钟 的 TODO 做 完了 ， 可 以 删除 了 。 再 看 看 还 剩 下 哪些 TODO。” 


在 看 剩 下 的 TODO 之 前 ， 咱 们 先 看 看 本 章 都 做 了 什么 事情 : 


1) 用 划分 测试 等 价 类 的 方法 将 测试 分 类 ， 从 每 一 类 测试 中 选择 有 代表 性 的 情况 进行 测试 。 


2) 在 用 “尽量 简单 ”的 标准 选择 了 第 一 个 测试 后 ， 又 用 能 够 引发 生产 代码 重 构 的 “尽量 有 意思 ”的 标准 选择 了 下 一 个 测试 ， 并 将 其 标记 为 working-on 的 TODO 来 进行 处 理 。 


3) 写 好 一 个 测试 的 Assert 部 分 之 后 ， 在 以 此 推导 出 该 测试 的 Act 和 Arrange 部 分 之 前 ， 用 面向 对 象 的 设计 方法 ， 思 考 了 如 何 用 一 个 业务 领域 的 类 HotelWorldClockSystem 来 封装 一 个 Java 的 ArrayList 
并 以 这 个 小 设计 为 基础 ， 来 推导 出 Act 和 Arrange 部 分 的 意图 代码 。 


4) 循 着 意图 代码 中 红色 的 编译 错误 的 指引 来 编写 最 少 的 代码 ， 以 消除 这 些 编译 错误 。 


5) 用 上 述 写 最 少 代 码 的 方法 令 编译 通过 后 ， 运 行 测试 时 必然 会 遇 到 空 指针 错 误 。 循 着 这 些 测试 运行 错误 的 指引 ， 继 续 编写 期 望 的 意图 代码 ， 以 解决 空 指针 问题 。 再 循 着 这 些 意图 代码 所 引发 的 编译 错误 


的 指引 ， 编 写 最 少 的 代码 ， 以 消除 这 些 编译 错误 。 如 此 循环 往复 ， 直 至 测试 运行 通过 。 


6) 当 信 心 充足 时 ， 可 以 把 步子 迈 得 大 一 些 。 不 等 出 现 编译 错误 和 测试 运行 错误 这 些 指引 时 ， 就 可 以 直接 编写 那些 显而易见 的 、 必 须 编 写 的 、 能 让 测试 运行 通过 的 、 最 少量 的 代码 。 


[1] 等 价 类 划分 就 是 解决 如 何 选 择 适当 的 数据 子 集 来 代表 整个 数据 集 的 问题 ， 通 过 降低 测试 的 数目 去 实现 “合理 的 ” 履 盖 ， 履 盖 了 更 多 的 可 能 数据 ， 以 发 现 更 多 的 软件 缺陷 。 一 一 引 自 百度 百科 


第 8 章 ” 嗅 出 代码 “ 腐 自 ”和 新 的 测试 点 


“ 按 Alt+6 快 捷 键 看 看 咱们 的 TODO 列 表 还 剩 下 什么 。 哦 ， 还 剩 下 最 后 一 个 有 关 构 造 器 重复 内 容 的 TODO。” 


目前 的 TODO 列 表 如 图 8-1 所 示 。 


Y Found 1 TODO item in 1 file 
y © tbc.tdd.hotelworldclocks (1 item in 1 file) 


y © CityClock.java 
E (10. 8) // TODO-working-on: The constructors of CityClock and PhoneClock are duplicated 


图 8-1 最 后 一 个 有 关 构造 器 重复 内 容 的 TODO 


这 个 TODO 要 做 的 事情 ， 是 消除 CityClock 和 PhoneClock 这 两 个 类 的 构造 器 中 重复 出 现 的 成 员 变 量 utcOffset。 解 决 的 方法 是 把 这 两 个 成 员 变量 移动 到 这 两 个 类 的 一 个 共同 的 父 类 的 成 员 变量 中 。 这 个 父 


类 可 以 叫做 Clock。 


还 是 用 意图 式 编程 来 做 。 可 以 先 让 CityClock 类 扩展 这 个 父 类 Clock。 


让 CityClock 类 扩展 父 类 Clock 的 意图 代码 如 下 (CM: Made class CityClock extend a new class Clock to eliminate the duplicated utcOffset field.) : 


-public class CityClock { 
+public class CityClock extends Clock{ 


在 上 面 这 段 意图 代码 中 ，Clock 类 出 现 红色 编译 错误 ， 因 为 它 还 未 创建 。 按 Alt+ Enter 快 捷 键 创建 它 。 


创建 Clock 类 的 代码 如 下 (CM: Created class Clock.) : 


+public class Clock { 
+} 


接 下 来 可 以 把 CityClock 类 中 的 成 员 变 量 utcOffset 移 动 到 父 类 Clock 中 了 。 可 以 先 在 父 类 Clock 中 写 一 行 声明 成 员 变 量 utcOffset 的 代码 : “protected int utcOffset; ” ， 因 为 需要 其 子 类 来 继承 这 个 成 


员 变 量 ， 所 以 用 protected 关 键 字 来 修饰 。 然 后 在 CityClock 类 中 删除 它 的 utcOffset 成 员 变 量 ， 并 把 所 有 的 this.utcOffset 都 改 为 super.utcOffset。 其 实 不 这 么 改 也 能 运行 ， 但 改 完 后 ， 能 清楚 地 表达 这 个 
utcOffset 来 自 父 类 。 


把 CityClock 类 中 的 成 员 变 量 utcOffset 移 动 到 父 类 Clock 的 代码 如 下 (CM: Made class CityClock use the field utcOffset from the super class Clock.) : 


public class Clock { 
+ protected int utcOffset; 
} 
public class CityClock extends Clock{ 
= private int utcOffset; 
private int utcZeroTime; 
// TODO-working-on: The constructors of CityClock and PhoneClock are duplicated 


public CityClock(int utcOffset) { 
this.utcOffset = utcOffset; 
中 super.utcOffset = utcOffset; 
} 
public int getTime() { 
= return (this.utcOffset + this.utcZeroTime + 24) % 24; 
a return (super.utcOffset + this.utcZeroTime + 24) % 24; 


“对 Clock 类 的 另 一 个 子 类 PhoneClock 也 如 此 办 理 。” 


让 PhoneClock 类 继承 Clock 类 ， 并 把 其 中 的 成 员 变 量 utcOffset 移 动 到 父 类 Clock， 代 码 如 下 所 示 (CM: Made class PhoneClock use the field utcOffset from the super class Clock.) : 


-public class PhoneClock { 
+public class PhoneClock extends Clock { 
private CityClock cityClock; 
= private int utcOffset; 
private HotelWorldClockSystem hotelWorldClockSystem; 
public PhoneClock(int utcOffset) { 
= this.utcOffset = utcOffset; 
tf super.utcOffset = utcOffset; 
} 


public void setTime(int time) { 
for (CityClock cityClock : this.hotelWorldClockSystem.getClocks()) { 
- cityClock.setUtcZeroTime (time - this.utcOffset) ; 
+ cityClock.setUtcZeroTime (time - super.utcOffset) ; 


“运行 测试 一 下 。 测 试 全 部 通过 。 这 个 TODO 也 完成 了 ， 可 以 删 掉 了 。” 


别 忘 了 把 PhoneClock 类 中 那些 因 被 替换 而 不 再 使 用 的 用 来 保存 单个 城市 时 钟 的 相关 代码 也 删除 掉 。 


删除 PhoneClock 类 中 因 被 替换 而 不 再 使 用 的 用 来 保存 单个 城市 时 钟 的 相关 代码 如 下 (CM: Removed the finished TODO and unused code from class PhoneClock.) : 


public class PhoneClock extends Clock { 
= private CityClock cityClock; 
private HotelWorldClockSystem hotelWorldClockSystem; 
public PhoneClock(int utcOffset) { 
super.utcOffset = utcOffset; 
} 
public void setCityClock(CityClock cityClock) { 
this.cityClock = cityClock; 
} 


运行 一 下 测试 。 测 试 依然 运行 通过 ! 


“现在 所 有 TODO 都 已 经 完成 了 ， 是 不 是 这 个 用 TDD 做 的 操练 可 以 结束 了 ? ” 


虽然 以 前 所 有 记录 下 来 的 TODO 都 完成 了 ， 但 我 觉得 还 差 一 步 工作 要 做 ， 那 就 是 最 后 审阅 一 下 已 经 完成 的 测试 代码 和 生产 代码 ， 找 出 还 未 测 到 的 情况 和 遗漏 的 代码 “ 腐 息 ”。 对 于 未 测 的 情况 ， 要 加 新 
的 测试 ， 对 于 新 发 现 的 “ 腐 臭 ”， 要 立即 重 构 。 只 有 这 一 步 做 完了 ， 才 能 告 一 段落 。 不 过 以 后 要 是 发 现 这 些 测试 和 生产 代码 又 有 了 新 的 未 测 情况 和 遗漏 掉 的 代码 “ 腐 臭 ”， 还 有 重复 上 述 步骤 。 这 样 说 起 
来 ， 代 码 编写 没有 结束 的 时 候 。 


p 


“我 想起 了 一 个 咱们 没有 测 到 的 地 方 ， 就 是 手机 自身 的 时 间 ， 也 应 该 用 它 设置 其 他 城市 时 钟 的 时 候 ， 自 动 调整 好 。” 


对 ， 咱 们 需要 加 上 这 个 测试 。 再 写 上 一 个 Assert 断 言 。 


[ 


“在 这 个 Assert 中 ， 我 期 望 phoneClock 对 象 能 有 一 个 getTime () 方法 。 这 就 是 我 的 意图 代码 。” 


当 用 手机 设置 其 他 城市 时 钟 时 其 自身 的 时 间 也 应 自动 调整 好 的 测试 和 其 中 的 断言 如 下 (CM: Added test 


the time of the phone clock should be set correctly after its setTime () method is invoked () .) : 


public class HotelWorldClocksTest { 


+ 


+ // TODO: the time of the phone clock should be set correctly after its 
setTime() method is invoked 
+ @Test 


+ public void the time of the phone clock should be set correctly after its_ 
SetTime method is invoked() { 


+ // Assert 
+ assertEquals (9, phoneClock.getTime()); 
+ } 


“从 这 个 Assert 可 以 很 容易 地 推导 出 这 个 测试 的 Act， 即 把 手机 时 钟 设置 为 9 点 。 然 后 又 推导 出 Arrange， 即 创建 一 个 PhoneClock 实 例 ， 并 且 在 创建 时 传 入 UTC 时 差 。” 


从 上 述 Assert 推 导出 这 个 测试 的 Act 和 Arrange 的 代码 如 下 所 示 :: 


public class HotelWorldClocksTest { 


@Test 

public void the time of the phone clock should be set correctly after its_ 
SetTime method is invoked() { 
// Arrange 
PhoneClock phoneClock = new PhoneClock (8); 


// Act 
phoneClock. setTime (9); 


十 十 十 十 十 十 


// Assert 
assertEquals (9, phoneClock.getTime ()); 


“为 了 让 这 个 测试 快速 运行 通过 ， 直 接 让 PhoneClock 类 的 getTime () 方法 返回 假 数据 9。 运 行 测试 。 吴 ， 空 指针 错误 ? 哦 ，PhoneClock 类 的 setTime () 方法 目前 需要 遍历 它 的 成 员 变 量 
hotelWorldClockSystem 中 保存 的 各 个 城市 的 时 钟 对 象 。 但 咱们 这 个 测试 没有 为 这 个 成 员 变 量 赋值 ， 所 以 出 现 空 指针 错误 。 在 前 面 加 一 个 判断 就 行 了 。” 


让 PhoneClock 类 的 getTime () 方法 直接 返回 假 数据 9 并 在 setTime () 方法 里 加 判断 ， 代 码 如 下 (CM: Made the test to pass by fake it in PhoneClock.getTime () .) : 


public class PhoneClock extends Clock { 


public void setTime (int time) { 


十 if (this.hotelWorldClockSystem == null) return; 
for (CityClock cityClock : this.hotelWorldClockSystem.getClocks()) { 
cityClock.setUtcZeroTime (time - super.utcOffset) ; 
} 


public int getTime() { 
return 9; 


++++; 


} 


在 PhoneClock 类 中 加 了 getTime () 方法 后 ， 我 发 现 这 个 方法 和 另 一 个 类 CityClock 中 的 getTime () 方法 虽然 实现 不 一 样 ， 但 是 方法 签名 完全 一 样 。 是 不 是 可 以 从 这 两 个 方法 中 提取 一 个 抽象 方法 ， 
放 到 父 类 Class 中 ， 用 父 类 的 抽象 方法 来 消除 子 类 方法 签名 的 重复 呢 ? 


“应 该 可 以 。 不 过 咱们 现在 手 上 的 有 关 手 机 自身 时 间 的 测试 还 没完 成 呢 。” 


可 以 把 这 个 新 发 现 的 问题 写 一 个 TODO， 等 完成 手 上 这 个 TODO 之 后 再 处 理 。 


目前 TODO 列 表 如 图 8-2 所 示 。 


v Found 2 TODO items in 2 files 


了 [eq tbc.tdd.hotelworldclocks (2 items in 2 files) 
了 © PhoneClock.java 
B (24, 8) // TODO: PhoneClock.getTimeQ and CityClock.getTime( are duplicated 
v @ HotelWorldClocksTest.java 
B (62, 8) // TODO-working-on: the time of the phone clock should be set correctly after its setTime0) method is 


图 8-2 ”加 上 一 个 新 发 现 的 TODO 待 以 后 处 理 


“接着 处 理 目前 手 上 的 TODO。 前 面 学 到 了 ， 在 PhoneClock 类 的 getTime () 方法 中 直接 返回 的 那个 假 数据 9， 和 测试 中 的 9 重复 了 。 解 决 的 方法 是 把 生产 代码 PhoneClock 类 的 getTime () 方法 中 的 
9 蔡 换 成 变量 。 可 以 在 PhoneClock 类 中 创建 一 个 存储 手机 当前 时 间 的 成 员 变量 time， 来 蔡 换 这 个 假 数据 9。“ 


PhoneClock 类 的 成 员 变量 time 蔡 换 假 数据 9 的 意图 代码 如 下 (CM: Wrote the intention code in PhoneClock.getTime () to return the local time which will be set in the method 


setTime () .) : 


public class PhoneClock extends Clock { 
// TODO: PhoneClock.getTime() and CityClock.getTime() are duplicated 
public int getTime() { 

= return 9; 

+ return this.time; 


“在 这 个 意图 代码 中 ，this:time 尚 未 在 PhoneClock 类 中 定义 。 利 用 Alt+ Enter 快 捷 键 创建 它 ， 并 且 在 PhoneClock 类 的 setTime () 方法 中 给 它 赋值 。” 


创建 PhoneClock 类 的 time 成 员 变量 并 在 setTime () 方法 中 对 其 赋值 的 代码 如 下 (CM: Created field time in class PhoneClock and assigned value to it in method setTime () .) : 


public class PhoneClock extends Clock { 
private HotelWorldClockSystem hotelWorldClockSystem; 
+ private int time; 
public void setTime(int time) { 
this.time = time; 
if (this.hotelWorldClockSystem == null) return; 
for (CityClock cityClock : this. hotelWorldClockSystem.getClocks()) { 
cityClock.setUtcZeroTime (time - super.utcOffset) ; 


“运行 测试 ， 通 过 。 现 在 可 以 删 掉 这 个 处 理 手机 自身 时 间 的 TODO。 再 来 处 理 那 个 把 getTime () 方法 提取 到 父 类 作为 抽象 方法 的 TODO 吧 。” 
可 以 直接 在 Clock 类 中 添加 一 个 getTime () 抽象 方法 。 既 然 这 个 方法 是 抽象 的 ， 这 个 Clock 类 也 应 该 改 为 抽象 的 。 


在 Clock 类 中 添加 getTime () 抽象 方法 的 代码 如 下 (CM: Made class Clock abstract and added an abstract method getTime () for its subclasses PhoneClock and CityClock.) : 


-public class Clock { 
+public abstract class Clock { 
protected int utcOffset; 
+ public abstract int getTime(); 
} 


“运行 测试 ， 通 过 。” 


不 过 ， 此 时 最 好 在 Clock 类 的 那 两 个 子 类 的 getTime () 方法 前 面 加 上 @Override， 以 便 让 人 了 解 它们 覆 写 了 父 类 的 getTime () 方法 。 


在 Clock 类 的 两 个 子 类 的 getTime () 方法 前 面 加 上 @Override,， 代码 如 下 (CM: Added keyword @Override for the overridden method getTime () in the two subclasses.) : 


public class CityClock extends Clock{ 


本 @override 
public int getTime() { 
return (super.utcOffset + this.utcZeroTime + 24) % 24; 
} 


public class PhoneClock extends Clock { 


= // TODO-working-on: PhoneClock.getTime() and CityClock.getTime() are duplicated 
+ @override 
public int getTime() { 
return this.time; 


} 


“运行 测试 ， 通 过 。” 


还 记得 咱们 之 前 划分 的 测试 等 价 类 吗 ? 咱们 划分 了 3 个 测试 等 价 类 ， 目 前 只 测试 了 两 个 。 还 有 一 个 没 测 。 


“记得 。 没 测 的 是 当地 时 间 比 UTC 时 间 早 的 城市 时 钟 。 当 时 没 测 的 原因 是 觉得 它 能 在 不 重 构 生产 代码 的 情况 下 直接 通过 ， 没 那么 有 意思 。” 


对 。 此 时 这 个 操练 的 主要 工作 都 做 完了 ， 有 些 富裕 时 间 了 。 如 果 咱 们 对 这 个 没有 测试 的 等 价 类 信心 不 足 ， 不 妨 把 它 如 上 。 咱们 可 以 测试 莫斯科 时 钟 。 莫 斯 科 时 间 比 UTC 时 间 早 4 小 时 。 只 要 简单 地 复制 一 
下 伦敦 时 钟 的 测试 ， 然 后 把 所 有 有 关 伦 敦 的 地 方 都 改 成 莫斯科 就 行 了 。 


测试 莫斯科 时 钟 的 测试 代码 如 下 (CM: Added test the time of clock Moscow should be 5 after the phone clock is set to 9 Beijing time () to cover the equivalence class of cities with 
positive UTC offset.) : 


public class HotelWorldClocksTest { 


+ 
+ @Test 

+ public void the time of clock Moscow should be 5 after the phone clock is_ 
set to 9 Beijing time() { 

// Arrange 

CityClock moscowClock = new CityClock (4); 

HotelWorldClockSystem hotelWorldClockSystem = new HotelWorldClockSystem() ; 
hotelWorldClockSystem. attach (moscowClock) ; 

PhoneClock phoneClock = new PhoneClock (8) ; 


// Act 
phoneClock.setHotelWorldClockSystem (hotelWorldClockSystem) ; 
phoneClock.setTime (9) ; 


// Assert 
assertEquals (5, moscowClock.getTime()); 


十 十 十 十 十 十 十 十 十 十 十 十 十 


mepa 


运行 测试 ， 通 过 。 
“终于 要 结束 了 !“ 


还 差 一 点 。 在 测试 代码 中 ， 有 没有 闻 到 重复 代码 的 “ 腐 臭 ”? 


“ 没 闻 到 呀 。” 


哈哈 ! 仔细 观察 一 下 目前 这 5 个 测试 各 自 的 Arrange 部 分 。 


“ 哦 。 是 有 两 处 重复 。 一 处 是 创建 HotelWorldClockSystem 对 象 ， 另 一 处 是 创建 Phone-Clock 对 象 。” 


对 。 咱 们 可 以 先 在 这 个 测试 类 中 创建 一 个 用 @Before 标 注 的 方法 ， 然 后 把 这 两 处 重复 都 提取 到 这 个 方法 中 ， 最 后 再 在 测试 类 中 创建 相应 的 成 员 变 量 ， 供 各 测试 方法 使 用 。 首 先 提 取 创建 
HotelWorldClockSystem 对 象 的 代码 。 


在 测试 类 中 把 创建 HotelWorldClockSystem 对 象 的 代码 提取 到 @ Before 标 注 的 方法 中 ， 代 码 如 下 (CM: Extracted the duplicated instantiation of class HotelWorldClockSystem into @Before in 


the test class.) : 


public class HotelWorldClocksTest { 
private HotelWorldClockSystem hotelWorldClockSystem; 


@Before 
public void initialize() { 

this.hotelWorldClockSystem = new HotelWorldClockSystem(); 
} 


i 十 十 十 十 十 十 十 


= HotelWorldClockSystem hotelWorldClockSystem = new HotelWorldClockSystem() ; 
= HotelWorldClockSystem hotelWorldClockSystem = new HotelWorldClockSystem() ; 
sa HotelWorldClockSystem hotelWorldClockSystem = new HotelWorldClockSystem() ; 
we HotelWorldClockSystem hotelWorldClockSystem = new HotelWorldClockSystem() ; 


= HotelWorldClockSystem hotelWorldClockSystem = new HotelWorldClockSystem() ; 


运行 测试 ， 通 过 。 接 着 提取 创建 PhoneClock 对 象 的 代码 。 
在 测试 类 中 把 创建 PhoneClock 对 象 的 代码 提取 到 @Before 标 注 的 方法 中 ， 代 码 如 下 (CM: Extracted the duplicated instantiation of class PhoneClock into @Before in the test class.) : 


public class HotelWorldClocksTest { 

private HotelWorldClockSystem hotelWorldClockSystem; 
+ private PhoneClock phoneClock; 

@Before 

public void initialize() { 

this.hotelWorldClockSystem = new HotelWorldClockSystem() ; 

+ this.phoneClock = new PhoneClock (8) ; 

} 


DT PhoneClock phoneClock = new PhoneClock (8); 
a Fe PhoneClock phoneClock = new PhoneClock (8) ; 


_ PhoneClock phoneClock = new PhoneClock (8) ; 


PhoneClock phoneClock = new PhoneClock (8) ; 


Er PhoneClock phoneClock = new PhoneClock (8); 


现在 基本 上 把 能 发 现 的 测试 代码 和 生产 代码 的 “ 腐 臭 ”， 以 及 能 想到 的 测试 都 处 理 完了 。 不 过 ， 是 否 选择 将 测试 代码 中 的 重复 代码 移动 到 测试 类 的 以 @Before 标 注 的 方法 中 ， 以 消除 重复 ， 也 是 因 人 而 
为 有 人 认为 这 些 重复 的 代码 在 每 个 测试 中 都 是 上 下 文 的 一 部 分 ， 如 果 被 提取 到 @Before 中 ， 会 造成 在 阅读 测试 代码 时 频繁 地 跳跃 ， 产 生 不 便 ， 所 以 这 部 分 人 偏向 于 不 提取 测试 中 的 重复 代码 。 


在 把 这 个 TDD 开 发 方法 和 前 面 那 个 测试 后 运行 的 方法 进行 对 比 前 ， 咱 们 先 看 看 本 章 做 了 哪些 工作 。 


1) 将 子 类 构造 器 中 出 现 的 重复 的 成 员 变量 上 移 到 父 类 中 ， 以 消 


as. 


2) 将 那些 因 被 替换 而 不 再 被 调用 的 代码 删除 掉 。 


3) 完成 了 所 有 列 出 的 TODO， 也 重新 审阅 了 已 经 完成 的 测试 代码 和 生产 代码 ， 找 出 还 未 测 到 的 情况 和 遗漏 的 代码 “ 腐 臭 ”。 对 于 未 测 的 情况 ， 要 增加 新 的 测试 对 于 新 发 现 的 “ 腐 臭 ”， 要 做 


4) 在 对 某 个 TODO 任 务 进行 


it 
or 


的 过 程 中 ， 随 着 代码 的 变化 ， 又 浮现 出 了 新 的 重复 代码 ， 这 时 把 这 些 新 出 现 的 代码 “ 腐 臭 ”写成 TODO 以 做 备 忘 ， 然 后 再 接着 重 构 当前 的 TODO。 


5) 遇 到 了 两 个 子 类 中 有 相同 签名 的 方法 ， 但 是 实现 各 不 相同 。 此 时 从 这 两 个 方法 中 提取 一 个 抽象 方法 ， 将 其 放 到 父 类 中 ， 以 解决 这 两 个 子 类 的 方法 签名 的 重复 问题 。 


6) 虽然 有 一 个 以 前 未 测 的 等 价 类 的 测试 ， 能 在 当前 生产 代码 上 直接 运行 通过 ， 虽 和 然 不 那么 有 意思 ， 但 为 了 增强 对 这 类 等 价 类 的 信心 ， 还 是 添加 了 一 个 测试 来 覆盖 它 。 


7) 在 测试 类 中 发 现 了 各 个 测试 方法 的 Arrange 部 分 中 出 现 了 重复 代码 ， 把 这 些 重复 代码 移动 到 测试 类 的 以 @ Before 标 注 的 方法 中 ， 以 消除 测试 代码 中 的 重复 代码 。 


8) 通过 操练 我 们 学 到 了 以 下 技能 : 


a) 每 次 重 构 代码 后 都 随时 运行 测试 ， 以 检查 是 否 破坏 了 原 有 代码 行为 。 


b) 是 否 选 择 将 测试 代码 中 的 重复 代码 移动 到 测试 类 中 以 @Before 标 注 的 方法 中 以 消除 重复 ， 也 因 人 而 异 。 因 为 有 人 认为 这 些 重复 的 代码 在 每 个 测试 中 都 是 上 下 文 的 一 部 分 ， 如 果 被 提取 到 @Before 
， 会 造成 阅读 测试 代码 时 频繁 地 跳跃 ， 产 生 不 便 ， 所 以 这 部 分 人 偏向 于 不 提取 测试 中 的 重复 代码 。 


第 9 章 ”测试 后 行 vs 测试 先行 


在 分 别 用 测试 后 行 的 开发 方法 和 TDD 开 发 方法 完成 了 同一 个 编程 操练 的 题目 后 ， 现 在 是 时 候 来 把 这 两 种 方法 进行 对 比 了 。 


为 了 便于 进行 对 比 ， 需 要 把 这 两 种 方法 所 开发 出 来 的 代码 描述 出 来 ， 而 UML 类 图 就 是 一 种 用 来 描述 代码 静态 结构 的 方法 。 我 把 这 两 种 方法 所 编写 出 来 的 生产 代码 用 类 图 分 别 画 出 来 了 ， 请 仔细 加 以 比 
较 ， 或 许 能 得 到 一 个 有 意思 的 发 现 。 


测试 后 行 的 开发 方法 所 编写 的 生产 代码 的 类 图 如 图 9-1 所 示 。 


Clock 
#UTC_OFFSET: int 
+attach(cityName:String,clock:Clock) (> #localTime: int 


+detach(cityName: String) +setLocalTime(localTime: int) 
+notifyALlClocks() +setLocalTimeFromUtcZeroTime(utcZeroTime: int) 
+getTime(): String 


TimeSubject 


#clocks 8...’ 


UtcTime 
SS 
+getUtcZeroTime( ) 9..1 -utcTime 
+setUtcZeroTime(utcZeroTime: int) 

+<<Override>> notifyAllClocks() 
+printTime0fALLCLocks() 


PhoneClock 


CityClock 
+CityClock(utcOffset: int) 
+<<Override>> setLocalTime( LocalTime: int) 


SSSSSSSSqqjx&»j» 
<>] +PhoneC Lock (utcOffset :int) 

+<<Override>> setLocalTime(localTime: int) 
+setUtcTime(utcTime:UtcTime) 


图 9-1 用 测试 后 行 的 开发 方法 所 编写 的 生产 代码 的 类 


TDD 开 发 方法 所 编写 的 生产 代码 的 类 图 如 图 9-2 所 示 。 


“这 两 张 图 很 像 ! 而 且 在 用 TDD 开 发 出 来 的 生产 代码 中 ， 把 TimeSubject 和 UtcTime 合 并 成 HotelWorldClocksystem 这 一 个 类 ， 竟 然 解决 了 前 面 提 到 的 照搬 设计 模式 导致 设计 出 不 必要 的 抽象 的 问 
题 !“ 


HotelWorldClockSystem 


+attach(cityClock:CityClock): void 
+getClocks(): ArrayList<CityCLlock> 


-cityCLocks 


telWorldClockSystem 


PhoneClock 


CityClock 


+PhoneClock(utcOffset:int) +CityClock(utcOffset:int) 
+setTime(time:int): void +<<Override>> getTime(): int 


+setHotelWorldCLlockSystem(hwcs :HotelWorldClockSystem): void +setUtcZeroTime(utcZeroTime:int): void 
+<<Override>> getTime{): int 


图 9-2 ”用 TDD 开 发 方法 所 编写 的 生产 代码 的 类 图 


最 妙 的 是 ， 这 一 切 都 是 咱们 在 没有 提 设计 模式 一 个 字 的 情况 下 ， 用 TDD 开 发 方法 ， 一 点 一 点 地 对 TODO、 测 试 代码 和 生产 代码 进行 重 构 ， 最 后 让 Observer 这 个 设计 模式 自己 浮现 出 来 的 。 


除了 在 设计 模式 的 运用 方面 的 “照搬 ”与 “浮现 ”的 区 别 ， 咱 们 可 以 把 前 面 罗列 的 测试 后 行 的 开发 方法 所 暴露 的 5 个 问题 再 简单 回顾 一 下 ， 并 看 看 用 TDD 开 发 方法 是 否 确实 解决 了 这 些 问题 。 


1) 文档 经 常 与 代码 缺乏 同步 。 测 试 后 行 的 开发 方法 是 把 文档 作为 代码 编写 的 沟通 基础 ， 然 而 由 于 文档 与 代码 的 同步 工作 很 繁琐 ， 经 常 导 致 文档 过 时 。 而 TDD 开 发 方法 是 把 代码 本 身 当成 代码 编写 的 沟通 
基础 ， 这 体现 在 测试 代码 命名 、 生 产 代码 命名 、TODO 注 释 列表 命名 、Commit Message 提 交 注 解 等 各 个 方面 。 这 些 命名 既是 文档 ， 同 时 也 是 能 够 被 运行 的 代码 ， 这 就 保证 了 文档 与 代码 的 天 然 同步 。 而 作 
为 文档 的 Commit Message 提 交 注 解 ， 会 跟随 所 修改 的 代码 ， 作 为 不 可 算 改 的 档案 ,永久 地 记录 到 版 本 管理 系统 的 代码 库 里 。 这 也 天 然 地 保证 了 文档 与 代码 的 同步 。 


2) Smain () 方法 进行 的 测试 无 法 让 计算 机 自动 判断 软件 行为 是 否 符合 预期 。 测 试 后 行 的 开发 方法 ， 通 常 需要 编写 main () 方法 来 进行 测试 。 但 这 种 测试 的 预期 结果 是 保存 在 人 脑 中 的 ， 需 要 人 工 来 
判断 main () 方法 的 输出 是 否 符合 预期 ， 效 率 低下 。 而 TDD 开 发 方法 ， 能 把 测试 的 期 望 值 也 写成 Assert 语 句 来 告诉 程序 ， 使 得 计算 机 能 够 代 蔡 人 脑 来 判断 结果 是 否 符合 预期 ， 而 且 这 个 过 程 能 够 通过 运行 命 
令 来 自动 化 ， 大 大 提高 了 效率 。 


3) 问题 产生 后 没 能 立即 发 现 。 测 试 后 行 的 开发 方法 在 编写 完 相应 代码 后 ， 没 能 立即 发 现 城市 时 钟 的 时 间 全 是 9 点 和 出 现 -4 点 这 些 问题 ， 直 到 写 main () 方法 运行 时 才 发 现 。 而 TDD 开 发 方法 ， 因 为 是 先 
写 测试 并 能 够 频繁 地 运行 测试 ， 所 以 在 运行 测试 时 ， 若 发 现 像 上 述 那样 代码 行为 不 符合 测试 中 规定 的 预期 结果 的 问题 ， 就 能 立即 反馈 给 程序 员 来 加 以 修正 。 省 去 了 后 面 测 试 工程 师 填 写 bug 报 告 、 开 发 经 理 
按 优先 级 对 bug 排 序 和 程序 员 阅 读 bug 报 告 、 搭 建 环境 重 现 问题 、 回 忆 当 初 是 如 何 编程 这 些 无 谓 的 时 间 和 人 金钱 的 浪费 ， 把 无 情 地 耗费 了 测试 工程 师 、 开 发 经 理 和 程序 员 的 大 量 工作 时 间 的 黑洞 消灭 在 萌芽 状 


za 


To 


4) 照搬 设计 模式 导致 设计 出 不 必要 的 抽象 和 编写 出 从 未 被 调用 的 方法 。 测 试 后 行 的 开发 方法 ， 一 般 会 趋向 于 设计 一 个 能 适应 “未 来 ”变化 的 、 带 有 许多 不 必要 的 抽象 的 复杂 设计 。 而 TDD 开 发 方法 ， 由 
于 专注 在 用 “最 少量 ”的 代码 让 编译 和 测试 运行 通过 ， 并 且 还 要 治理 代码 “ 腐 臭 ”。 这 就 从 根本 上 消灭 了 产生 不 必要 的 抽象 和 编写 出 从 未 被 调用 的 方法 的 土壤 。 


5) 程序 调试 过 程 无 法 让 计算 机 来 蔡 代 并 自动 化 地 反复 使 用 。 测 试 后 行 的 开发 方法 遇 到 bug 时 一 般 都 会 在 IDE 中 设置 断 点 来 调试 程序 ， 因 其 过 程 繁琐 、 无 法 让 计算 机 自动 复 用 且 bug 出 现 的 范围 未 被 限 
定 ， 而 导致 效率 低下 。 而 TDD 开 发 方法 ，bug 都 会 在 由 计算 机 自动 且 反 复 运行 的 测试 中 被 发 现 ， 且 bug 出 现 的 范围 被 限定 在 一 个 个 粒度 很 小 的 测试 之 内 ， 便 于 程序 员 定位 错误 ， 效 率 很 高 。 


如 果 把 上 面 描述 的 TDD 开 发 方法 对 这 5 个 问题 的 解决 方法 归纳 一 下 ， 我 们 能 看 出 TDD 开 发 方法 具有 以 下 优势 : 


) 把 代码 本 身 当成 代码 编写 的 沟通 基础 ， 令 代码 成 为 可 以 运行 的 文档 ， 会 让 那些 代码 即 文档 的 读者 一 一 包括 程序 员 、 测 试 工程 师 、 产 品 专家 等 一 一 在 理解 代码 行为 方面 反馈 迅速 。 


2) 把 测试 的 期 望 值 写 成 Assert 语 句 告诉 计算 机 ， 使 


能 够 代替 人 脑 来 判断 结果 是 否 符合 预期 ， 会 让 程序 员 在 感知 代码 问题 方面 反馈 迅速 。 


Ww 


) 先 写 测试 并 频繁 地 运行 测试 以 立即 发 现 错误 ， 会 让 程序 员 、 测 试 工程 师 和 开发 经 理 等 所 有 与 代码 相关 的 人 在 感知 代码 问题 方面 反馈 迅速 。 


4) 专注 在 用 “最 少量 ”的 代码 让 编译 和 测试 运行 通过 ， 接 着 治理 代码 “ 腐 臭 ”， 通 过 计算 机 自动 且 反 复 运 行 的 测试 ， 发 现 那些 被 限定 在 一 个 个 粒度 很 小 的 测试 之 内 bug， 都 会 让 程序 员 在 维护 代码 质量 
方面 反馈 迅速 。 


从 后 一 个 编程 操练 可 以 看 出 ，TDD 开 发 方法 ， 会 使 我 们 在 理解 代码 行为 、 感 知 代码 问题 和 维护 代码 质量 方面 都 反馈 迅速 ， 而 带 来 这 个 优势 的 根源 是 用 这 种 方法 所 编写 出 的 代码 。 据 此 我 们 可 以 得 出 这 样 
的 结论 : 用 TDD 开 发 方法 所 开发 出 来 的 代码 ， 会 使 与 代码 相关 的 所 有 人 ， 在 对 代码 的 行为 理解 、 问 题 感知 和 质量 维护 方面 ， 都 反馈 迅速 ， 其 结果 就 是 节省 所 有 这 些 人 的 时 间 、 精 力 和 人 金钱。 


在 用 编程 操练 分 别 体验 了 测试 后 行 的 开发 方法 和 TDD 开 发 方法 之 后 ， 我 们 再 反观 用 这 两 种 方法 所 开发 出 来 的 代码 ， 哪 种 代码 更 像 本 书 所 讨论 的 主题 一 一 烂 代 码 呢 ?要 回答 这 个 问题 ， 我 们 需要 了 解 什么 
是 烂 代 码 。 


在 了 解 烂 代码 之 前 ， 先 回顾 一 下 本 章 的 内 容 : 


1) 用 TDD 开 发 方法 ， 能 在 不 事先 考虑 设计 模式 的 情况 下 ， 通 过 反复 消除 代码 “ 腐 臭 ”， 最 终 能 让 设计 模式 在 代码 中 自然 地 浮现 出 来 。 这 样 浮现 出 来 的 设计 模式 ， 身 材 苗条 ， 一 点 没有 那些 用 照搬 设计 模 
式 而 产生 无 用 的 “ 歼 肉 ”代码 。 


2) 用 TDD 开 发 方法 所 开发 出 来 的 代码 ， 会 使 与 代码 相关 的 所 有 人 ， 在 对 代码 的 行为 理解 、 问 题 感知 和 质量 维护 方面 ， 都 反馈 迅速 ， 从 而 节省 所 有 这 些 人 的 时 间 、 精 力 和 金钱 。 


第 10 章 ”何谓 “ 烂 代码 


在 正式 介绍 什么 是 烂 代码 之 前 ， 先 来 看 一 个 小 故事 。 


一 天 ， 正 走 在 取经 路 上 的 唐僧 ， 忽 听见 山脚 下 几 声 震 耳 欲 压 的 叫喊 : “师父 ! 师父 ! ”唐僧 忙 走 过 去 ， 在 石 颖 中 见 到 一 个 猴子 。 那 猴子 问 明 唐 僧 是 去 西天 取经 的 ， 便 说 : “我 是 500 年 前 大 闹 天 宫 的 齐 
天 大 圣 ， 因 为 欺骗 领导 ， 被 如 来 佛 压 在 这 里 。 不 久 前 观音 车 萨 依 如 来 佛 旨意 去 找 取经 人 路 过 这 里 ， 我 求 他 救 我 。 他 劝 我 再 莫 行 凶 ， 版 依 佛法 ， 努 力 保护 取经 人 去 西方 拜佛 取经 ， 功 成 后 自 有 好 处 。 我 就 答应 
下 来 ， 日 夜 盼 望 师父 前 来 救 我 。 我 愿 做 你 徒弟 ， 保 护 您 取经 。 ”唐僧 满心 欢喜 ， 救 了 悟空 出 来 。 


司空 出 来 后 与 唐僧 一 路 前 行 ， 突 然 见 一 猛虎 。 悟 空 大 叫 一 声 : “哪里 去 ! ” 那 猛虎 竟然 被 惊 得 动 也 不 敢 动 ， 趴 在 地 上 任凭 悟空 一 棒 打 死 。 吓 得 唐僧 掉 下 马 来 ， 咬 着 手指 说 : “天 哪 ! 昨天 我 看 见 那 本 地 
匣 人 打 一 只 斑 澜 猛虎， 还 斗 了 老 半 天 。 今 日 你 不 费力 气 ， 只 一 棒 就 把 那 虎 打 个 稀 烂 ， 强 ! ” 


不 久 ， 他 们 又 遇 到 6 个 歹徒 抢 动 ， 司 空 又 不 费 吹 灰 之 力 将 这 6 人 全 都 打 死 。 气 得 唐僧 说 : “他 们 虽 是 强盗 ， 却 罪 不 该 死 。 你 一 味 杀 生 ， 如 何 做 得 和 尚 ” 太 可 恶 了 ! " SRT IMRAN, RMS 
挑 子 不 干 ， 搬 下 师父 去 东海 龙王 那里 串门 喝 茶 去 了 。 唐 僧 只 得 自己 独自 赶路 。 而 知晓 这 一 切 的 观音 车 萨 ， 变 做 一 个 老 太 太 去 见 唐僧 ， 并 把 为 悟空 准备 的 棉衣 和 谱 金 花 帽 交 给 唐僧 ， 还 教会 了 唐僧 念 紧 籍 允 。 
而 悟空 听从 了 龙王 和 观音 的 劝告 ， 回 到 了 师父 身边 。 他 在 行李 中 瞧见 了 衣服 和 帽子 ， 便 穿戴 起 来 。 唐 僧 一 见 ， 便 默默 念 起 紧 短 咒 ， 从 此 那 帽子 里 的 金 籍 便 在 悟空 的 脑袋 上 生 下 根来 ， 无 法 摘 下 ， 而 且 越 收 越 
紧 ， 疼 得 悟空 满 地 打滚 。 唐 僧 问 : “你 今后 还 敢 无 礼 吗 ? ”悟空 口 里 虽说 : “不 敢 了 。” 但 仍 心怀 不 善 ， 扯 出 金 短 棒 要 对 唐僧 下 手 。 慌 得 唐僧 又 念 了 3 饥 紧 籍 咒 ， 疼 得 悟空 委 了 铁 棒 ， 趴 在 地 上 求饶 。 当 悟空 
得 知 这 一 切 都 是 观音 的 安排 后 ， 便 死心 塌 地 地 保护 唐僧 西天 取经 。 


这 里 的 孙悟空 ， 在 我 看 来 ， 就 是 一 段 烂 代码 。 原 因 在 后 面 会 进行 说 明 。 


本 书 所 讨论 的 “ 烂 代码 ”这 个 词 ， 在 国外 一 般 叫 Legacy Code， 但 是 这 个 英文 词 翻译 成 中 文 就 被 译 为 “遗留 代码 ”。 而 国内 的 许多 上 T 从 业者 ， 对 “遗留 代码 ”又 有 自己 的 解释 ， 与 其 所 对 应 的 英文 
Legacy Code 的 本 义 有 所 不 同 。 为 了 讨论 方便 ， 在 本 书 中 出 现 的 “遗留 代码 ”的 含义 就 是 英文 Legacy Code 的 本 义 。 


在 国外 讨论 软件 编写 的 书籍 中 ， 描 述 与 本 书 主题 “ 烂 代码 ”相近 概念 的 英文 词汇 有 若干 个 ， 包 括 Legacy Code (遗留 代码 ) 、Bad Code] (糟糕 的 代码 ) A Big Ball of Mud?! (大 泥 球 ) 、 
Crap ( 烂 东西 ) 、A Mess (一 个 烂 肉 子 ) 和 Impossible to Work with?) (不 可 驹 之 朽木 代码 ) 。 


上 述 描述 烂 代码 的 英文 词汇 中 ， 在 国外 影响 力 最 大 的 当 属 Michael C.Feathers 在 他 所 著 Working Effectively with Legacy Code 一 书 中 所 描述 的 “遗留 代码 ”。Feathers 在 书 中 对 于 遗留 代码 表达 了 下 
面 的 观点 内: 


“ 遗留 代码 的 严格 定义 “就 是 指 从 其 他 人 那儿 得 来 的 代码 ”。 
“ “在 业内 人 士 的 口中 ，“ 遗 留 代码 ”一 词 常 常 是 “无 法 理解 的 、 难 以 修改 的 代码 ”的 代名词 。” 


“然而 ， 在 多 年 来 与 形形色色 的 开发 团队 共事 并 帮助 他 们 解决 重大 的 编码 问题 的 过 程 中 ， 我 总 结 出 了 一 个 不 同 的 定义 。 对 我 来 说 ， 遗 留 代码 就 是 那些 没有 编写 相应 测试 的 代码 。 明 白 这 一 点 是 很 痛苦 


“没有 编写 测试 的 代码 是 糟糕 的 代码 (Bad Code) 。 不 管 我 们 有 多 细心 地 去 编写 它们 ， 不 管 它们 有 多 漂亮 、 面 向 对 象 或 封装 良好 ， 只 要 没有 编写 测试 ， 我 们 实际 上 就 不 知道 修改 后 的 代码 是 变 得 更 好 
了 还 是 更 焰 了 。 反 之 ， 有 了 测试 ， 我 们 就 能 够 迅速 、 可 验证 地 修改 代码 的 行为 。” 


Michael C.Feathers 为 “遗留 代码 ”所 做 的 “ 没 写 测试 ”的 定义 在 国外 的 影响 如 此 之 大 ， 以 至 于 让 “ 没 写 测试 ”一 举 超越 “无 法 理解 和 难以 修改 ”， 在 国外 成 为 遗留 代码 “事实 上 的 标准 定义 5)” 。 


Jip} 


在 前 面 列举 的 若干 与 烂 代码 合 义 相近 的 英文 词汇 中 ， 把 烂 代码 描述 得 最 为 生动 形象 的 当 属 “ 大 泥 球 ”。 该 英文 词汇 的 发 明 人 Brian Foote 和 Joseph Yoder 是 如 下 形象 地 描述 “大 泥 球 ”的 器 : 


“ 大 泥 球 代码 就 是 一 个 结构 混乱 、 建 意 蔓延 、 轻 浮 草 率 、 贴 满 补丁 、 私 搭 乱 建 、 一 团 乱 麻 的 丛林 。 
“ 这 类 系统 明确 无 误 地 显现 出 无 序 增长 、 反 复 修 补 和 权宜 修复 的 迹象 。 

“ 信息 在 系统 的 互 不 相干 的 部 分 之 间 杂 乱 地 被 共享 。 

“ 在 这 类 系统 中 ， 经 常 几乎 所 有 的 重要 信息 都 会 变 为 全 局 的 或 重复 的 。 

“ 系统 的 总 体 结构 可 能 从 未 被 很 好 地 定义 过 ， 就 算 以 前 定义 过 ， 也 被 侵蚀 得 面目 全 非 ， 只 要 有 一 点 点 软件 架构 意识 的 程序 员 都 会 躲避 这 样 的 “泥潭 ”。 


“ 只 有 那些 不 关心 软件 架构 的 程序 员 ， 和 那些 或 许 乐于 在 一 个 即将 垮 掉 的 堤防 上 每 天 做 修 修补 补差 事 的 程序 员 ， 才 愿意 工作 在 这 样 的 系统 上 。 


从 这 里 可 以 看 出 ， 那 些 结构 混乱 、 重 复元 余 和 依赖 全 局 信息 的 系统 ， 可 以 被 称 为 “大 泥 球 ”。 


从 上 面 Legacy Code 和 A Big Ball of Mud 这 两 个 英文 词汇 的 描述 可 以 看 出 ， 本 书 所 讨论 的 “ 烂 代码 ”在 国外 程序 员 的 观念 中 ， 就 是 指 那些 没 写 测试 、 无 法 理解 、 难 以 修改 、 结 构 混乱 、 
全 局 信息 的 代码 。 


由 


复元 余 和 依赖 


讨论 了 国外 程序 对 烂 代码 的 看 法 之 后 ， 我 们 把 视点 再 转 到 国内 程序 员 。 


从 目前 所 掌握 的 资料 来 看 ， 国 内 出 版 物 中 ， 尚 无 专门 论述 烂 代码 ， 并 给 出 明确 定义 的 书籍 。 而 烂 代码 一 词 经 常 出 现在 国内 程序 员 的 口头 交流 、 微 博 和 博客 中 。 


我 对 公益 编程 操练 社区 “bjdp.org 北 京 设计 模式 学 习 组 ”[/] 中 的 一 些 程序 员 和 新 浪 微 博 的 网 友 (以 下 简称 : 微 博 网 友 ) 对 烂 代码 的 主要 评论 进行 了 归纳 ， 从 中 可 以 看 出 ， 国 内 程序 员 一 般 认为 ， 烂 代码 
就 是 那些 难以 理解 、 难 以 维护 和 人 皆 写 过 的 代码 。 


烂 代码 难以 理解 的 问题 ， 一 般 表现 在 下 面 3 个 方面 : 命名 不 清 、 多 层 幅 套 和 滥用 模式 。 


“ 命名 不 清 。“ 烂 代码 从 烂 命名 开始 。 国 ”“ 一 扒 烂 代码 看 着 头 大 ， 命 名 能 再 不 靠 谱 一 点 吗 ? 趾 ” 命 名 不 清 导 致 的 直接 后 果 就 是 看 不 懂 代 码 ，“ 看 不 懂 的 就 是 烂 代码 。[10” 
“ 多 层 庶 套 。“ 烂 代码 一 般 剖 具备 多 层 谋 套 的 特性 。 我 最 不 喜欢 的 就 是 类 似 for 循 环 下 诬 套 着 另 一 个 for 循 环 ， 接 着 再 谋 套 一 个 if 语 句 ， 然 后 再 诬 套 男 一 个 if 语 句 这 样 的 代码 。[111” 


“ 滥用 模式 。 设 计 模 式 是 草 含 在 代码 的 内 在 逻辑 里 面 的 ， 而 不 是 人 为 给 加 上 的 。“ 好 代码 是 容易 看 懂 ， 易 于 维护 ， 便 于 扩展 ， 兼 顾 细 节 的 。 烂 代码 是 模式 一 堆 ， 调 套 层 出 ， 看 不 清楚 ， 杭 不 明 
白 。13” 设 计 模 式 的 运用 应 该 是 发 乎 自然 ， 而 不 是 扭捏 作 态 的 。“ 软 件 的 设计 ， 就 像 您 要 放 的 一 个 屁 。 如 果 您 必须 要 迫使 自己 把 它 放出 来 ， 那 么 出 来 的 或 许 是 一 坨 尿 。1 引 ”这 话 虽 然 不 雅 ， 但 是 却 指出 了 一 
条 真理 : 每 个 健康 的 人 都 会 放屁 ， 这 是 自然 现象 ， 就 让 它 自 然 地 放出 来 吧 (当然 要 注意 场合 ) 。 就 如 同 老子 在 《道德 经 》 里 所 说 的 : “人 法 地 ， 地 法 天 ， 天 法 道 ， 道 法 自然 。” 如 果 要 生生 地 把 它 挤 出 来 ， 
那么 很 有 可 能 您 就 需要 洗 裤子 了 。 


代码 难以 维护 的 问题 ， 一 般 表 现在 下 面 3 个 方面 : 代码 元 余 、 难 以 扩展 和 不 如 重 写 。 


: 代码 宛 余 。“…… 想 到 的 是 公司 那些 大 量 宛 余 烂 代码 ， 几 万 行 的 一 个 代码 文件 ， 编 译 起 来 是 不 是 要 比 高 质量 、 重 构 得 当 的 代码 要 时 间 长 很 多 呢 ? 11”“ 现 场 分 析 一 些 典 型 的 烂 代 码 ， 会 发 现 传递 信息 


的 粒度 太 大 、 代 码 完 余 、 方 法 的 定义 不 精准 等 问题 。1” 源 代码 拷贝 和 粘贴 是 造成 代码 完 余 的 最 主要 的 祸根 。“ 拷 贝 粘 贴 是 万 恶 之 源 ， 为 了 快速 完成 任务 ， 拷 贝 代码 成 了 权宜 之 计 。19”“ 烂 代码 更 容易 被 
Copy，Paste 后 成 为 更 烂 的 代码 ， 可 变更 性 更 差 ， 导 致 更 高 的 pug 率 ， 导 致 陷入 万 动 不 复 之 地 。[ "1” 

: 难以 扩展 。“ 烂 代码 就 是 耦合 度 高 的 代码 。1H”“ 烂 代码 就 是 代码 质量 不 高 、 难 以 扩展 、 难 以 维护 、 出 bug 概 率 高 的 代码 。[ 

“ 不 如 重 写 。 很 多 程序 员 由 于 缺乏 驯服 烂 代码 的 心 法 和 手法 ， 在 看 到 难以 维护 的 烂 代码 时 ， 往 往 产 生 “ 不 如 重 写 ” 的 念头 。“ 我 理解 的 烂 代码 ， 就 是 不 想 再 碰 ， 也 不 敢 碰 的 代码 。 如 果实 在 要 改 ， 不 如 
重新 来 过 。[20”“ 重 写 比 驯服 也 许 更 经 济 。E” 

烂 代 码 “ 人 缘 写 过 ”这 一 点 不 难 理解 。 比 如 在 程序 员 刚 刚 接触 一 个 疡 新 的 行业 领域 ， 或 者 刚刚 开始 学 习 一 门 新 的 编程 语言 ， 或 者 刚 从 面向 过 程 的 开发 转向 面向 对 象 的 开发 时 ， 那 时 写 出 的 代码 就 像 中 路 
学 步 的 孩子 ， 虽 然 能 走 两 步 ， 但 是 跌跌撞撞 ， 经 常 摔跤 。 等 后 来 水 平 提高 了 再 回头 看 时 ， 都 会 有 不 堪 回 首 的 感觉 。“ 有 了 时候 刚 骂 完 烂 代码 ， 一 查 版 本 历史 才 知道 是 自己 写 的 ， 然 后 都 不 敢 相信 。[22]” “我 看 
见 自己 以 前 写 的 那些 烂 代码 ， 都 不 想 承认 那 是 我 写 的 代码 。P3]" 


总 之 ， 如 果 让 国内 程序 员 拉 心 自问 的 话 ， 大 家 都 写 过 一 些 难以 理解 和 难以 维护 的 烂 代 码 。 


在 上 面 列举 的 国内 外 程序 员 对 于 烂 代码 的 各 种 定义 和 不 同 描述 中 ， 能 和 否 归纳 出 一 些 有 共性 的 东西 呢 ? 经 过 对 这 个 问题 的 长 期 思考 ， 我 认为 烂 代码 应 该 具有 下 面 3 点 共性 : 


1) 烂 代码 都 是 能 够 运行 的 。 不 管 代码 是 多 么 难以 理解 和 难以 维护 ， 甚 至 会 有 bug， 但 它 至 少 应 该 是 可 以 运行 ， 能 看 到 一 些 结果 的 。 不 能 运行 的 代码 就 不 能 被 称 为 代码 ， 而 只 能 被 称 为 一 堆 字符 串 。 


2) 烂 代码 都 是 需要 修改 其 中 的 bug 或 在 其 中 增加 新 功能 的 。 如 果 一 段 代 码 运行 得 很 好 ， 而 且 目 前 也 暂时 没有 与 其 相关 的 bug 或 开发 新 功能 ， 那 么 即使 这 段 代 码 写 得 再 难以 理解 和 难以 维护 ， 那 么 它 也 不 
会 被 纳入 本 书 所 讨论 的 要 驯服 的 烂 代码 的 范畴 。 直 到 有 一 天 我 们 需要 修改 其 中 的 bug 或 在 其 中 增加 新 功能 时 ， 我 们 再 称 其 为 烂 代码 也 不 迟 。 这 样 做 的 好 处 是 ， 我 们 能 够 避免 因 做 那些 没有 任何 业务 价值 的 事 
情 而 造成 浪费 9。 


3) 烂 代码 对 于 其 编写 者 、 测 试 者 和 维护 者 来 说 都 是 反馈 迟 组 的。 在 软件 开发 中 ， 下 面 这 种 场景 ?是 不 是 很 常见 ? “添加 一 点 小 产品 特性 ， 就 冒 出 两 个 bug! 之 前 是 谁 写 的 这 代码 ? 关联 来 关联 去 ， 也 
没 说 明 。” 添 加 小 产品 特性 时 就 会 出 bug， 造 成 小 产品 特性 完工 拖延 ， 这 就 是 在 添加 新 功能 方面 反馈 迟缓 。 另 外 ， 在 使 用 测试 后 行 的 开发 方法 所 进行 的 本 书 的 第 一 个 编程 操练 的 过 程 中 ， 我 们 也 都 看 到 了 在 
理解 代码 行为 、 感 知 代码 问题 和 维护 代码 质量 方面 反馈 迟缓 的 例子 。 


除了 上 面 的 常见 场景 ， 咱 们 可 以 再 逐一 看 看 前 面 提 到 的 国内 外 程序 员 对 于 烂 代码 的 各 种 描述 ， 来 看 它们 是 不 是 在 某 种 程度 上 都 是 反馈 迟缓 的 。 


难以 理解 的 代码 比 起 容易 理解 的 代码 ， 对 于 代码 的 编写 者 和 维护 者 ， 在 了 解 这 些 代码 的 行为 方面 的 反馈 要 迟缓 得 多 。 


如 果 代 码 没 写 可 以 自动 化 运行 的 测试 ， 那 么 我 们 只 能 通过 测试 工程 师 手工 测试 来 了 解 代码 的 行为 是 否 符合 预期 。 很 明显 ， 手 工 测试 比 起 自动 化 测试 来 说 要 慢 很 多 。 所 以 没 写 测试 的 代码 比 起 有 自动 化 测 
试 的 代码 ， 对 于 代码 的 测试 者 ， 在 代码 行为 的 验证 方面 的 反馈 要 迟缓 得 多 。 


难以 维护 、 难 以 修改 、 结 构 混乱 、 重 复 匈 余 和 依赖 全 局 信息 的 代码 ， 比 起 那些 容易 维护 、 容 易 扩展 、 结 构 清晰 、 没 有 重复 、 封 装 良好 的 代码 ， 对 于 代码 的 编写 者 和 维护 者 ， 在 基于 这 些 代码 之 上 修改 


bug 或 新 增 功能 方面 的 反馈 要 迟缓 得 多 。 


找 出 了 上 述 3 点 烂 代码 的 共性 ， 我 们 现在 就 可 以 给 本 书 所 描述 的 烂 代码 下 个 定义 了 : 烂 代码 就 是 那些 能 够 运行 的 、 而 且 需 要 修改 其 中 的 bug 或 在 其 中 增加 新 功能 的 、 但 对 于 代码 的 编写 者 、 测 试 者 和 维护 


者 来 说 反馈 迟缓 的 代码 。 简 而 言 之 ， 烂 代码 就 是 反馈 迟缓 的 代码 。 这 里 的 反馈 包括 了 解 代码 行为 、 验 证 代码 行为 和 在 这 些 代码 之 上 修改 bug 或 新 增 功能 等 方面 。 


有 了 烂 代码 的 上 述 定义 ， 咱 们 回 过 头 来 看 看 第 一 个 编程 操练 。 


根据 烂 代码 的 定义 ， 在 编写 main () 方法 测试 之 前 ， 所 有 咱们 根据 细 化 后 的 类 图 所 编写 的 那 几 个 类 的 代码 ， 严 格 说 起 来 连 烂 代码 都 算 不 上 ， 只 能 算是 一 些 字符 串 ， 因 为 它们 都 不 能 


了 main () 方法 ， 使 得 那些 类 可 以 运行 了 ， 这 些 代 码 才 有 了 可 以 被 称 为 烂 代码 的 资格 : 能 够 运行 。 


当 我 们 第 一 次 和 第 二 次 运行 main () 方法 时 ， 分 别 发 现 了 两 个 bug， 第 一 个 bug 是 所 有 城市 时 钟 都 是 9 点 ， 第 二 个 bug 是 出 现 了 -4 点 这 个 不 合理 的 时 间 ， 我 们 需要 修改 bug。 


等 我 们 修复 了 上 述 两 个 bug， 第 三 次 运行 main () 方法 得 到 期 望 的 结果 后 ， 我 们 能 说 此 时 的 代码 就 不 是 烂 代 码 了 吗 ” 还 不 行 。 


运行 。 


直到 咱们 编写 


因为 我 们 又 发 现代 码 中 暴露 出 下 面 一 些 反馈 迟缓 的 问题 : 首先 ， 我 们 在 开发 中 所 时 刻 依赖 的 细 化 


后 的 类 图 ， 随 着 开发 的 进行 而 先后 更 改 了 8 次 ， 如 果 这 8 次 修改 没有 及 时 同步 到 类 


[ 


严重 依赖 这 份 未 更 新 的 类 图 的 话 ， 那 么 这 份 旧 类 图 就 会 使 我 们 对 于 代码 行为 的 理解 发 生 偏差 ， 令 代码 在 代码 编写 者 和 维护 者 了 解 其 行为 方面 反馈 迟缓 。 


其 次 ， 由 于 咱们 刻板 地 按照 “四 巨头 ”在 讨论 Observer 设计 模式 时 给 出 的 类 图 而 画 出 了 相应 的 类 | 


图 | 


中 ， 而 以 后 的 开发 又 


， 结 果 设 计 出 Timesubject 和 UtcTime 这 两 个 其 实 可 以 合并 的 类 ， 多 设计 了 TimeSsubject.detach () 


和 UtcTime.getUtcZeroTime () 这 两 个 从 未 被 调用 的 方法 。 这 是 一 种 浪费 ， 而 浪费 的 后 果 是 令 程序 员 在 单位 时 间 里 ， 阅 读 和 管理 了 不 必要 的 代码 ， 从 而 减少 了 阅读 和 管理 必要 代码 的 时 间 ， 也 使 得 代码 在 


程序 员 了 解 其 行为 方面 反馈 迟缓 。 


最 后 ， 咱 们 这 个 编程 操练 是 通过 手工 运行 main () 方法 和 设置 断 点 调试 程序 来 获得 代码 的 行为 是 否 符合 预期 的 反馈 的 ， 但 是 这 种 反馈 ， 比 起 可 以 复 用 的 自动 化 测试 来 说， 为 代码 测试 者 提供 的 反馈 要 迟 


所 以 ， 第 一 个 编程 操练 最 后 生成 的 带 有 main () 方法 的 代码 ， 仍 然 是 一 段 需 要 继续 驯服 的 烂 代 码 。 


再 看 看 本 章 开头 唐僧 收 悟空 为 徒 时 的 司空， 是否 也 符合 烂 代码 的 那 3 点 共性 呢 ? 首先 ， 悟 空 能 


轻易 


也 降服 取经 路 上 所 遇 到 的 狼 虫 虎 狗 和 妖怪 强盗 ， 说 明 悟 空 能 够 起 到 保护 唐僧 的 作 . 


， 可 以 运行 ; 其 次 ， 


悟空 有 一 味 杀 生 行 凶 这 个 bug， 需 要 修复 ， 而 且 还 要 增加 版 依 佛法 的 “新 功能 ”; 最 后 ， 悟 空 接受 不 了 唐僧 的 教诲 ， 撤 下 师父 独自 离 去 ， 这 对 于 悟空 的 “维护 者 ”唐僧 来 说 ， 悟 空 对 其 


的 。 


所 以 ， 悟 空 即 使 刚刚 接受 完 如 来 佛 把 他 压 在 五 行 山下 的 驯服 ， 在 拜 唐僧 为 师 时 ， 也 还 是 一 段 需 要 继续 驯服 的 烂 代码 。 


定义 了 什么 是 烂 代码 后 ， 接 下 来 咱们 要 做 几 个 驯服 烂 代 码 的 编程 操练 。 不 过 接 下 来 的 编程 操练 题目 与 之 前 的 那个 不 同 。 前 


在 操练 之 前 ， 先 回顾 一 下 本 章 的 内 容 : 


1) 国外 程序 员 认为 烂 代码 就 是 那些 没 写 测试 、 无 法 理解 、 难 以 修改 、 结 构 混乱 、 重 复元 余 和 依赖 


2) 国内 程序 员 认为 烂 代码 难以 理解 和 维护 ， 而 且 自 己 以 前 多 多 少 少 也 写 过 一 些 烂 代码 。 


3) 本 书 对 烂 代码 的 定义 ， 包 含 了 烂 代码 的 3 点 共性 : 能 够 运行 、 需 要 修改 其 中 的 bug 或 在 其 中 增加 新 功能 、 对 于 代码 的 编写 者 、 测 斌 者 和 维护 者 来 说 反馈 迟缓 。 简 而 言 之 ， 烂 代码 就 是 


码 。 


4] Michael C.Feathers 著 ， 刘 未 鹏 译 ，《 修 改 代码 的 艺术 》， 人 民 邮 电 出 版 社 ，2007 年 11 月 第 1 版 ， 
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局 信息 的 代码 。 


1] Legacy Code 和 Bad Code 的 出 处 参见 : Michael C. Feathers,Working Effectively with Legacy Code,Prentice Hall PTR,2004 年 9 月 22 日 ，Preface。 
2] A Big Ball of Mud 的 出 处 参见 : Brian Foote,Joseph Yoder,Big Ball of Mud Fourth Conference on Patterns Languages of Programs(PLoP’ 97/EuroPLoP’ 97) Monticello, Illinois, September 1997 . 


3] Crap, A Mess4eImpossible to Work with 的 出 处 参见 : Daniel Brolund,Ola Ellnestam,Behead Your Legacy Beast,2012-2 925 H , www.agical.com/mikmeth/mikadomethod.pdf. 


5] Daniel Brolund,Ola Ellnestam,Behead Your Legacy Beast,2012#2 254, Preface www.agical.com/mikmeth/mikadomethod.pdf. 


教化 的 


is like a fart.If you need to force it,it's probably 


24 本 书 有 关 烂 代码 的 第 二 点 共性 ， 是 受 软 件 开 发 咨询 师 姚 若 舟 (Joseph) 的 建议 的 启发 。 参 见 : http://www.infoq.com/cn/news/2014/03/garbage-code-discuss。 


第 11 章 ”记录 所 疗 到 的 “ 腐 自 " 


馈 也 是 迟缓 


面 的 那个 题目 是 从 零 开始 编写 代码 ， 而 接 下 来 的 题目 是 要 驯服 已 有 的 烂 代码 。 


反馈 迟缓 的 代 


shit. 出 自 : 


我 相信 ， 世 界 上 100% 的 程序 员 每 天 都 会 面临 烂 代 码 的 问题 。 


“ 那 可 不 一 定 ， 有 些 开 发 新 项 目的 程序 员 是 从 零 开始 编程 的 。” 


对 ， 我 以 前 在 工作 中 也 做 过 从 零 开始 的 开发 项 目 。 但 是 我 发 现 ， 如 果 不 做 代码 重 构 的 话 ， 那 些 从 零 开始 写 出 的 代码 ， 当 天 就 会 变 成 充满 代码 “ 腐 臭 ”的 烂 代码 。 过 段 时 间 ， 代 码 就 会 臭 不 可 闻 ， 以 至 于 
烂 得 不 可 收拾 。 此 时 即使 推翻 重 写 ， 若 还 是 不 重 构 的 话 ， 最 终 的 代码 还 是 会 沦 为 烂 代码 。 但 即便 是 像 Kent Beck 这 样 的 精通 重 构 的 TDD 开 发 方法 的 创立 者 ， 每 天 也 在 驯服 烂 代码 。 


“此 话 怎 讲 ?“ 


Kent Beck 提 出 了 Red-Green-Refacotr ( 变 红 - 变 绿 - 重 构 ) 这 样 的 TDD 开 发 的 “六 字 真 言 ”。 他 把 TDD 开 发 方法 过 程 演变 为 这 个 “六 字 真 言 ”的 一 个 接着 一 个 的 进 代 。 其 中 Red 表 示 先 写 一 个 运行 失败 
(在 IDE 中 会 变 红 ) 的 测试 ，Green 表 示 可 以 用 最 省 事 的 办 法 让 该 测试 运行 通过 (在 IDE 中 会 变 绿 ) ，Refactor 表 示 在 测试 的 保护 下 把 刚才 写 的 那些 最 省 事 的 代码 中 的 诸如 重复 代码 这 样 的 “ 腐 臭 ”给 重 构 
好 。 从 这 个 过 程 能 够 看 出 ，Refactor 过 程 其 实 就 是 驯服 Green 步骤 所 产生 的 烂 代 码 。 这 样 阅 起 来 ， 无 论 是 否 做 代码 重 构 ， 程 序 员 每 天 都 会 面临 烂 代码 的 问题 。 


“ 咽 ， 驯 服 已 有 的 烂 代码 ， 其 实 就 可 以 看 成 是 从 头 用 TDD 写 新 代码 的 第 3 步 : Refactor, ” 


对 ， 不 过 在 做 Refactor 之 前 ， 需 要 针对 要 Refactor 的 行为 编写 测试 。 不 编写 测试 ， 而 直接 修改 代码 不 能 叫 Refactor， 只 能 叫 “ERA” |, 


前 面 操练 的 用 TDD 从 零 开始 写 代码 的 开发 方法 ， 为 咱们 驯服 已 有 烂 代码 做 好 了 铺垫 。 下 面 咱们 就 利 


前 面 所 学 到 的 技能 ， 来 驯服 一 段 已 有 的 烂 代 码 。 


ay 


这 段 烂 代码 所 对 应 的 编程 操练 题目 叫 Trivia ， 最 初 是 我 读 Emily Bache 所 著 的 The Coding Dojo Handbook[ 一 书 时 看 到 的 。 该 题目 专 为 操练 驯服 烂 代码 所 设计 ， 包 含 了 C+ +、(C#、Java、 
Javascript、Objective-C、PHP、Python、Ruby、scala 等 10 多 种 语言 的 版 本 。 这 些 语言 的 版 本 可 以 在 Emily 的 githubD] 页 面 上 找到 。 


Trivia 这 个 题目 实现 了 一 个 答题 间 关 的 游戏 。 几 个 参赛 的 玩家 通过 轮流 掷 色 子 (MIR) 来 决定 每 个 人 在 游戏 盘 上 的 位 置 (以 下 简称 : 玩家 位 置 ) ， 然 后 回答 问题 。 如 果 回 答 正确 就 会 获得 金币 ， 和 否则 
就 被 关 进 禁闭 室 。 被 关 禁 闭 的 玩家 ， 在 下 次 掷 色 子 时 ， 若 掷 出 的 点 数 是 奇数 ， 则 可 以 走出 禁闭 室 ， 继 续 在 游戏 盘 上 前 进 到 新 的 位 置 ， 并 有 机 会 通过 回答 问题 来 赢 取 金 币 ; 若 掷 出 的 点 数 是 偶数 ， 则 继续 在 禁 
闭 室 里 待 着 ， 不 能 前 进 和 回答 问题 。 一 旦 产生 了 第 一 个 获得 6 枚 金币 的 玩家 ， 游 戏 结束 。 


“看 一 看 源 代码 内 吧 。” 


源 代码 只 有 3 个 类 : Game 类 实现 了 这 个 游戏 的 所 有 接口 ， 相 当 于 服务 端 GameRunner 类 里 有 个 main () 方法 ， 调 用 了 Game 类 里 面 的 接口 来 运行 这 个 游戏 ， 相 当 于 客户 端 ; Game-Test 类 是 一 个 测 
试 类 ， 里 面 只 有 一 个 测试 “2+3=5” 的 这 个 必然 通过 的 测试 ， 用 来 验证 单元 测试 框架 JUnit 是 否 能 正常 工作 。 


先 看 一 下 客户 端 GameRunner 类 的 代码 。 


GameRunner 类 的 代码 如 下 所 示 口 : 


public class GameRunner { 
private static boolean notAWinner; 
public static void main(String[] args) { 
Game aGame = new Game () 7 
aGame.add ("Chet"); 
aGame.add ("Pat"); 
aGame.add("Sue") ; 
Random rand = new Random() ; 
do { 
aGame.roll(rand.nextInt (5) + 1); 
if (rand.nextInt(9) == 7) { 
notAWinner = aGame.wrongAnswer () ; 
} else { 
notAWinner = aGame.wasCorrectlyAnswered () ; 


} while (notAWinner) ; 


“这 个 客户 端的 代码 ， 首 先 新 建 一 个 Game 的 对 象 。 然 后 添加 了 3 个 玩家 ， 并 构建 了 一 个 随机 数 对 象 。 接 着 在 一 个 do…while 循 环 中 ， 首 先 掷 色 子 ， 然 后 回答 问题 ， 若 还 未 产生 赢家 ， 则 循环 继续 。 在 掷 
色 子 时 ， 用 上 面 那个 随机 数 对 象 来 模拟 产生 色 子 的 点 数 。 在 回答 问题 时 ， 还 用 这 个 随机 数 对 象 来 模拟 问题 回答 得 是 否 正确 这 种 随机 情况 。” 


可 以 运行 一 下 这 个 main () Aik 


运行 客户 端 GameRunner 类 的 main () 方法 的 部 分 输出 结果 如 下 所 示 : 


Chet was added 

They are player number 1 
Pat was added 

They are player number 2 
Sue was added 

They are player number 3 
Chet is the current player 
They have rolled a 5 
Chet's new location is 5 
The category is Science 
Science Question 0 
Answer was corrent!!!! 
Chet now has 1 Gold Coins. 
Pat is the current player 
They have rolled a 4 
Pat's new location is 4 
The category is Pop 

Pop Question 0 

Answer was corrent!!!! 
Pat now has 1 Gold Coins. 
Sue is the current player 


Sue now has 5 Gold Coins. 
Chet is the current player 
They have rolled a 3 
Chet's new location is 8 
The category is Pop 

Pop Question 2 

Answer was corrent!!!! 
Chet now has 6 Gold Coins. 


最 后 看 看 Game 类 ， 这 是 咱们 要 驯服 的 烂 代码 。 


Game 类 的 代码 如 下 所 示 !9]: 


public class Game { 
ArrayList players = new ArrayList (); 
int[] places = new int[6]; 
int[] purses = new int[6]; 


boolean[] inPenaltyBox = new boolean[6]; 

LinkedList popQuestions = new LinkedList (); 

LinkedList scienceQuestions = new LinkedList (); 

LinkedList sportsQuestions = new LinkedList (); 

LinkedList rockQuestions = new LinkedList (); 

int currentPlayer = 0; 

boolean isGettingOutOfPenaltyBox; 

public Game() { 

for (int i = 0; i < 50; i++) { 

popQuestions.addLast ("Pop Question " + i); 
scienceQuestions.addLast (("Science Question " + i)); 
sportsQuestions.addLast ( ("Sports Question " + i)); 
rockQuestions.addLast (createRockQuestion (i) ) ; 


} 


public String createRockQuestion(int index) { 
return "Rock Question " + index; 


} 
public boolean isPlayable() { 
return (howManyPlayers() >= 2); 


} 

public boolean add (String playerName) { 
players .add(playerName) ; 
places [howManyPlayers () ] 0; 
purses [howManyPlayers () ] 0; 
inPenaltyBox[howManyPlayers()] = false; 
System.out.println(playerName + " was added"); 
System.out.println("They are player number " + players.size()); 
return true; 


} 
public int howManyPlayers() { 
return players.size(); 


} 
public void roll(int roll) { 
System. out.println (players.get (currentPlayer) + " is the current player"); 
System.out.println("They have rolled a " + roll); 
if (inPenaltyBox[currentPlayer]) { 
if (roll $ 2 != 0) { 
isGettingOutOfPenaltyBox = true; 
System.out.println (players.get (currentPlayer) + " is getting 
out of the penalty box"); 


places[currentPlayer] = places[currentPlayer] + roll; 
if (places[currentPlayer] > 11) places[currentPlayer] = 
places[currentPlayer] - 12; 


System. out .Println (players.get (currentPlayer) 
+ "'s new location is " 
+ places [currentPlayer]); 
System.out.println("The category is " + currentCategory()); 
askQuestion (); 
} else { 
System.out.println (players.get (currentPlayer) + " is not 
getting out of the penalty box"); 
isGettingOutOfPenaltyBox = false; 


} else { 
places [currentPlayer] = places[currentPlayer] + roll; 
if (places[currentPlayer] > 11) places[currentPlayer] = 


places[currentPlayer] - 12; 
System.out .println (players.get (currentPlayer) 

+ "'s new location is " 

+ places [currentPlayer]); 
System.out.println("The category is " + currentCategory()); 
askQuestion (); 

} 
} 
private void askQuestion() { 
if (currentCategory() == "Pop") 
System. out.println (popQuestions.removeFirst ()); 
if (currentCategory() == "Science") 
System. out .Println (scienceQuestions.removeFirst ()); 


if (currentCategory() == "Sports") 
System. out.print1n (sportsQuestions.removeFirst ()); 
if (currentCategory() == "Rock") 


System.out .Println (rockQuestions.removeFirst ()); 
} 


private String currentCategory () 


{ 

if (places[currentPlayer] == 0) return 

if (places [currentPlayer] 4) return 

if (places [currentPlayer] 8) return 

if (places [currentPlayer] 1) return 

if (places [currentPlayer] 5) return 

if (places [currentPlayer] 9) return 

if (places [currentPlayer] 2) return 

if (places [currentPlayer] 6) return "Sports"; 
if (places [currentPlayer] 10) return "Sports"; 


return "Rock"; 
} 
public boolean wasCorrectlyAnswered() { 
if (inPenaltyBox[currentPlayer]) { 
if (isGettingOutOfPenaltyBox) { 
System.out.println ("Answer was correct!!!!"); 
purses [currentPlayer]++; 
System. out .println (players.get (currentPlayer) 
+" now has " 
+ purses [currentPlayer] 
+" Gold Coins."); 
boolean winner = didPlayerWin(); 
currentPlayert+; 
if (currentPlayer == players.size()) currentPlayer = 0; 
return winner; 
} else { 
currentPlayert+; 
if (currentPlayer == players.size()) currentPlayer = 0; 
return true; 


} 
} else { 
System.out.println ("Answer was corrent!!!!"); 
purses [currentPlayer]++; 
System. out .Println (players.get (currentPlayer) 
+" now has " 
+ purses [currentPlayer] 
+" Gold Coins."); 
boolean winner = didPlayerWin(); 
currentPlayert+; 
if (currentPlayer == players.size()) currentPlayer = 0; 
return winner; 


} 


} 

public boolean wrongAnswer() { 
System.out.println ("Question was incorrectly answered"); 
System.out.println (players.get (currentPlayer) + " was sent to the penalty box"); 
inPenaltyBox[currentPlayer] = true; 
currentPlayer++; 
if (currentPlayer 
return true; 


players.size()) currentPlayer = 0; 


} 
private boolean didPlayerWin() { 
return ! (purses[currentPlayer] == 6); 


} 


“这 么 长 的 代码 从 头 看 到 尾 也 得 要 看 一 阵子 。” 


我 以 前 也 是 从 头 到 尾 地 看 代码 ， 但 很 快 就 发 现 这 样 读 总 是 不 得 要 领 。 后 来 从 读书 中 获得 启发 ， 用 读书 时 找 书 中 章节 的 方法 来 读 代码 就 好 多 了 。 


“我 读书 时 也 是 会 时 不 时 地 看 看 目录 中 的 章节 ， 以 便 知 道 自己 看 到 哪里 ， 还 有 多 少 页 能 看 完 。 但 是 代码 里 面 哪里 有 章节 呢 ?” 


我 所 说 的 代码 里 的 章节 ， 其 实 指 的 是 服务 端 代码 里 的 公共 接口 ， 也 就 是 那些 声明 为 public 的 方法 的 定义 。 这 些 服务 端的 接口 ， 一 方面 被 客户 端 所 调用 ， 另 一 方面 也 必然 会 去 调用 服务 端 内 部 各 个 私有 方 
法 和 变量 。 有 这 些 接口 作为 指引 ， 就 能 按 图 索 驱 地 读 遍 所 有 代码 。 所 以 它们 的 作用 就 如 同 书 中 的 章节 一 样 。 


现在 咱们 的 任务 就 是 以 Game 类 的 公共 接口 为 索引 ， 参 照 客户 端 GameRunner 类 如 何 调用 这 些 接口 来 阅读 代码 。 可 以 先 把 这 个 任务 写成 TODO， 并 标 上 working-on， 表 示 咱 们 正在 执行 这 个 任务 。 


在 Game 类 中 添加 有 关 阅 读 代 码 的 TODO 如 下 所 示 (CM: Working on TODO: Check public interface of the server-side code to see how it is being used by the client-side code.) : 


public class Game { 
+  // TODO-working-on: Check public interface of the server-side code to see 
how it is being used by the client-side code 
public Game() { 
for (int i = 0; i < 50; it+) { 


以 利用 IDEA 里 面 的 Structure 工 具 窗 口 来 显示 Game 类 的 所 有 public 方 法 ， 并 将 其 设置 为 能 与 源 代 码 同步 显 示 ， 以 方便 阅读 代码 。” 


gj 


利用 IDEA 里 面 的 Structure 工 具 窗口 来 显示 Game 类 的 所 有 接口 如 图 11-1 所 示 。 


tbc-trivia-java - [~/OOR/katas/remote/tbc-trivia-java/tbc-trivia-java] - [tbc-trivia-java] - .../src/main/ja 
File Edit View Navigate Code Analyze Refactor Build Run Tools VCS Window Help 
fatbe-trivia-java ) © src ) © main ) D java ) © kata ) Ej trivia ) © Game 》 4 


@ GameRunner.java x | (© GameTest,java x == 


: package kata.trivia; 


© Game.java x 


ject 


1: Pro 


@ ù createRockQuestion(int): String import 本 
@ ù isPlayable(): boolean 
@ ù add(String): boolean B ; 
@ b howManyPlayers(): int ArrayList players = new ArrayList(); 

@ b roll(int): void int[] places = new int[6]; 

=f ‘ int[] purses = new int[6]; 

ae a AD pe boolean ~  boolean[] inPenaltyBox = new boolean[6]; 

ù wrongAnswer(): boolean 


“i 


public class Game { 


LinkedList popQuestions = new LinkedList(); 
LinkedList scienceQuestions = new LinkedList(); 
LinkedList sportsQuestions = new LinkedList(); 
LinkedList rockQuestions = new LinkedList(); 


图 11-1 Structure 工具 窗口 


Game 类 有 8 个 public 方 法 ， 也 就 是 说 有 8 个 接口 。 咱 们 一 个 一 个 地 看 一 下 。 


Game () 这 个 构造 器 把 游戏 中 用 于 提问 的 流行 歌曲 (Pop) 、 科 学 (Science) 、 体 育 (Sports) 和 摇滚 歌曲 (Rock) 这 4 个 问题 链表 通过 一 个 循环 赋 了 初 值 。 


createRockQuestion () 方法 用 于 创建 有 关 摇 滚 歌曲 的 问题 。 这 个 方法 有 两 个 问题 。 首 先 ， 它 仅仅 被 上 面 那个 Game () 构造 器 所 使 用 ， 客 户 端 没有 使 用 ， 所 以 声明 为 public 是 没有 必要 的 。 另 外 ， 它 
仅 返 回 有 关 Rock 的 问题 字符 串 供 rockQuestions 链 表 使 用 ， 这 与 Game () 构造 器 中 其 他 3 个 链表 的 初始 化 工作 没什么 不 同 。 所 以 这 个 方法 其 实 没有 做 什么 重要 的 事情 ， 可 以 大 致 对 应 那 22 种 “ 腐 臭 ” [7] 中 的 
那个 Lazy Class (TX) “ 腐 臭 ”， 完 全 可 以 inline。 


“现在 就 inline 它 吧 。” 


要 inline 它 ， 但 现在 还 不 是 时 候 。 因 为 现在 working-on 的 TODO 是 读 代 码 ， 而 不 是 重 构 代 码 。 另 外 ， 现 在 的 代码 还 没有 得 到 任何 测试 的 保护 。 在 没有 测试 保护 的 情况 下 就 修改 代码 ， 前 面 已 经 讲 
重 构 ， 而 只 能 叫 “裸奔 ” ， 因 为 不 知道 这 个 改动 是 不 是 会 破坏 原 有 代码 的 行为 。 


= 


肯定 
这 不 能 


“要 是 现在 不 管 它 ， 接 下 来 继续 读 代码 ， 就 会 忘记 的 。” 
可 以 先 写 个 TODO 把 在 读 代 码 时 发 现 的 问题 记 下 来 ， 等 将 来 测试 写 好 了 再 解决 不 迟 。 


在 Game 类 中 添加 有 关 将 方法 createRockQuestion () 进行 inline 的 TODO 如 下 所 示 (CM: Added TODO: inline method Game.createRockQuestion () .) : 


public class Game { 


+ // TODO: inline method Game.createRockQuestion () 
rockQuestions.addLast (createRockQuestion (i) ) 7 
} 
} 


虽然 inline 的 方法 createRockQuestion () 能 够 同时 解决 该 方法 不 应 该 是 public 的 问题 ， 但 现在 还 未 到 重 构 代码 的 时 候 ， 所 以 咱们 现在 还 是 写 个 TODO 把 这 个 问题 记 下 来 。 


在 Game 类 中 添加 有 关 将 createRockQuestion () 方法 改 为 private 的 TODO， 具体 如 下 所 示 (CM: Added TODO: Change method Game.createRockQuestion () to be private.) : 


public class Game { 


+ // TODO: Change method Game.createRockQuestion() to be private 
public String createRockQuestion(int index) { 
return "Rock Question " + index; 


} 


看 完了 两 个 接口 ， 接 着 看 第 3 个 接口 isPlayable () 。 这 个 方法 判断 当前 的 玩家 数量 是 不 是 大 于 等 于 2， 如 果 是 的 话 ， 就 返回 true。 看 起 来 这 个 方法 的 意图 是 说， 游戏 只 有 在 有 两 个 或 两 个 以 上 的 玩家 玩 


时 ， 才 可 以 玩 。 


“不 过 这 个 方法 在 IDEA 中 显示 为 灰色 的 ， 表 示 没有 被 任何 代码 调用 。” 


对 。 这 样 说 来 ， 这 个 方法 或 许 在 将 来 有 用 ， 但 目前 没 用 。 这 个 “ 腐 自 ”味道 是 不 是 和 22 种 “ 腐 自 ”中 的 那个 Speculative Generality ( 夸 夸 其 谈 未 来 性 ) “ 腐 臭 ”有 点 像 ”对 付 这 种 “ 腐 臭 ”的 办 法 就 是 
删 掉 它 ， 等 将 来 真 的 需要 时 再 写 不 迟 。 不 过 现在 还 没 到 删除 的 时 候 ， 先 写 个 TODO。 


在 Game 类 中 添加 有 关 将 isPlayable () 方法 进行 删除 的 TODO， 有 具体 如 下 所 示 (CM: Added TODO: Remove the unused method Game.isPlayable () .) : 


public class Game { 


+ // TODO: Remove the unused method Game. isPlayable() 
public boolean isPlayable() { 
return (howManyPlayers() >= 2); 
} 


接 下 来 看 下 一 个 接口 add () 。 这 个 接口 将 玩家 的 名 字 加 入 players 链 表 ， 另 外 还 将 3 个 数组 元 素 的 值 初始 化 。 这 3 个 数组 元 素 分 别 记 录 了 下 一 个 玩家 位 置 (places[]) . #7 
闭 室 (inPenaltyBox[]) 的 情况 。 接 着 用 System.out.println () 打印 一 些 信息 出 来 ， 然 后 返回 true。 


和 数量 (purses[]) 和 是 否 在 禁 


“这 个 方法 插 有 意思， 最 后 返回 true。 但 这 个 返回 值 在 客户 端 没 有 被 使 用 。” 


对 ， 这 个 true 返 回 得 既 没有 什么 道理 ， 又 没有 代码 使 用 它 。 似 乎 也 有 些 Speculative Generality ( 夸 夸 其 谈 未 来 性 ) “ 腐 臭 ”的 味道 。 


“既然 没有 代码 使 用 ， 那 就 在 将 来 改 一 下 这 个 接口 ， 让 它 返 回 void。” 


对 ， 可 以 先 用 TODO 记 录 下 来 。 另 外 ， 用 System.out.printIn () 打印 信息 ,虽然 方便 开发 时 的 调试 ， 但 使 用 起 来 很 不 灵活 ， 一 方面 不 能 长 期 保存 这 些 信息 ， 另 一 方面 不 能 在 需要 时 关闭 这 些 信息 输出 。 
不 如 把 这 些 信息 都 写 到 一 个 log 文 件 里 ， 这 样 既 可 以 方便 地 复制 或 读 取 log 文 件 ， 又 可 以 方便 地 设置 log 输 出 级 别 来 控制 是 否 输出 这 些 信息 。 针 对 这 个 问题 可 以 再 写 一 个 TODO。 


回 


在 Game 类 中 添加 有 关 add () 方法 返回 值 未 被 使 用 和 将 System.out.println () 蔡 换 为 log 的 两 个 TODO 如 下 所 示 (CM: Added 2: 1) The return value of method Game.add () is not used; 
2) Replace System.out.printIn () with a log method of a logger.) : 


public class Game { 


二 // TODO: The return value of method Game.add() is not used. 
public boolean add(String playerName) { 


inPenaltyBox [howManyPlayers()] = false; 
// TODO: Replace System.out.println() with a log method of a logger 
System.out.println(playerName + " was added"); 


System.out.println ("They are player number " + players.size()); 
return true; 


+ 


下 一 个 接口 是 howManyPlayers () 。 这 个 接口 返回 玩家 的 数量 。 看 起 来 似乎 对 客户 端 有 用 ， 但 实际 上 客户 端 并 没有 用 到 它 。 反 而 是 Game 类 内 部 的 


他 方法 在 使 用 它 。 


“可 以 把 它 从 一 个 public 的 接口 改 为 private 的 私有 方法 。” 


对 。 这 个 public 方 法 改 为 private 相 当 于 除去 了 这 个 接口 ， 使 得 Game 类 的 整个 接口 范围 变 得 更 窒 。 在 满足 现 有 客户 端的 需求 的 前 提 下 ， 接 口 要 设计 得 尽量 窒 ， 这 样 一 方 | 
注 ， 另 一 方面 能 消除 维护 这 些 额 外 接口 的 成 本 。 记 下 这 个 TODO。 


面 能 让 这 个 类 所 做 的 事情 更 加 专 


在 Game 类 中 添加 有 关 将 howManyPlayers () 方法 变 为 private 的 TODO 如 下 所 示 (CM: Added TODO: The method Game.howManyPlayers () should be private because it is only used by 
its own calss Game.) : 


public class Game { 
+ // TODO: The method Game.howManyPlayers() should be private because it is 
only used by its own calss Game 
public int howManyPlayers() { 
return players.size(); 


} 


下 一 个 接口 是 方法 roll () 。 这 个 方法 的 参数 roll 表 示 当 前 玩家 所 掷 色 子 的 点 数 。 如 果 当 前 玩家 没有 被 关 禁 闭 ， 或 者 当 正 在 被 关 禁 闭 的 玩家 所 掷 的 点 数 是 奇数 ， 从 而 从 禁闭 室 中 被 释放 出 来 时 ， 可 以 根据 
所 掷 点 数 来 在 游戏 盘 上 前 进 到 正确 的 位 置 ， 并 接受 提问 。 若 该 玩家 正在 被 关 禁 闭 ， 且 所 掷 的 点 数 是 偶数 的 ， 那 么 该 玩家 继续 被 关 禁 闭 。 


RI 


“这 个 roll () 方法 里 从 上 往 下 数 第 2 个 if 语句 和 第 2 个 else 语 句 中 的 大 部 分 内 容 都 是 重复 的 。 


对 。22 种 代码 “ 腐 臭 ”中 排名 第 一 的 Duplicated Code (重复 代码 ) “ 腐 臭 ”终于 出 现 了 。 记 下 这 个 TODO。 


在 Game 类 的 roll () 方法 中 添加 有 关 出 现 重复 代码 的 TODO 如 下 所 示 (CM: Added TODO: Duplicate code in method Game.roll () .) : 


public class Game { 


} else { 

+ // TODO: Duplicate code in method Game.roll() 
places[currentPlayer] = places[currentPlayer] + roll; 
if (places(currentPlayer] > 11) places[{currentPlayer] = 

places[currentPlayer] - 12; 


下 一 个 接口 是 wasCorrectlyAnswered () 方法 ， 做 玩家 答对 问题 后 的 事情 : 若 当前 玩家 没有 被 关 进 禁闭 室 ， 或 者 已 经 从 禁闭 室 释放 出 来 ， 就 奖励 玩家 一 块 金币 ， 然 后 计算 玩家 是 否 已 经 获得 6 块 金币 而 
胜出 并 结束 游戏 ， 接 着 选 出 下 一 位 玩家 ， 并 返回 玩家 是 否 获胜 的 结果 ; 若 当前 玩家 还 未 出 禁闭 室 ， 则 仅仅 选 出 下 一 位 玩家 ， 并 返回 true， 表 示 玩 家 尚未 获胜 。 


这 个 方法 的 返回 值 我 感觉 有 些 别 扭 : 它 是 一 个 boolean 型 ， 如 果 返 回 true 表 示 玩 家 尚未 获胜 ， 返 回 false 表 示 玩 家 已 经 获胜 。 这 里 返回 值 的 true 与 false， 和 其 所 代表 的 实际 语义 的 肯定 与 否定 正好 相 
让 我 理解 起 来 得 多 绕 一 道 弯 。 为 什么 不 用 如 下 等 价 的 表达 呢 : 如 果 返 回 true 表 示 游 戏 仍 在 继续 ， 返 回 false 表 示 游 戏 不 能 继续 玩 了 。 还 是 加 一 个 TODO 把 方法 didPlayerWin () 更 名 为 
isGameStilllnProgress () 好 一 些 。 


在 Game 类 中 添加 有 关 把 方法 didPlayerWin () 更 名 的 TODO 如 下 所 示 (CM: Added TODO: The name of the method Game.didPlayerWin () should be 
Game.isGameStilllnProgress () .) : 


public class Game { 
+ // TODO: The name of the method Game.didPlayerWin() should be Game. 
isGameStillInProgress () 
private boolean didPlayerWin() { 
return ! (purses[currentPlayer] == 6); 


} 


既然 didPlayerWin () 方法 要 改名 为 jsGamestillnProgress () ， 那 么 保存 它 的 返回 值 的 变量 winner 也 要 跟着 一 起 改名 为 jsGamestillnProgress。 再 加 一 个 TODO 记 录 这 个 问题 。 


在 Game 类 的 wasCorrectlyAnswered () 中 添加 有 关 变 量 winner 改 名 的 TODO 如 下 所 示 (CM: Added TODO: Rename variable'winnerto be'isGameStilllnProgress’.) : 


public class Game { 


$ // TODO: Rename variable 'winner' to be 'isGameStillInProgress'. 
boolean winner = didPlayerWin(); 


“这 里 又 有 重复 代码 了 。 这 个 wasCorrectlyAnswered () 方法 里 从 上 往 下 数 第 1 个 else 语 句 里 的 内 容 ， 与 第 2 个 if 语句 中 最 后 的 部 分 相 重复 。 另 外 ， 第 2 个 else 语 句 里 的 内 容 ， 与 第 2 个 if 语句 中 的 内 容 几 
乎 完全 相同 ， 除 了 else 语 句 里 有 一 个 corrent 的 拼写 错误 。 有 意思 的 是 ， 后 面 那 段 重复 代码 ， 又 包括 了 前 面 那 段 重 复 代 码 。” 


把 这 两 处 重复 代码 分 别 写 到 两 个 IODO 里 面 。 后 面 那 处 重复 代码 的 TODO 后 面 加 个 Outer， 表 明 它 包含 了 前 一 处 的 重复 代码 。 


在 Game 类 中 wasCorrectlyAnswered () 方法 里 添加 有 关 消 除 第 1 处 重复 代码 的 TODO 如 下 所 示 (CM: Added TODO: Duplicate code in method Game.wasCorrectlyAnswered () .) : 


public class Game { 


return winner; 
} else { 


+ // TODO: Duplicate code in method Game.wasCorrectlyAnswered () 
currentPlayer+t+; 
if (currentPlayer == players.size()) currentPlayer = 0; 


return true; 


在 Game 类 中 wasCorrectlyAnswered () 方法 里 添加 有 关 消 除 第 2 处 重复 代码 的 TODO 如 下 所 示 (CM: Added TODO: Duplicate code in method Game.wasCorrectlyAnswered () .Outer.) : 


public class Game { 


} else { 
+ // TODO: Duplicate code in method Game.wasCorrectlyAnswered(). Outer. 
System.out.println ("Answer was corrent!!!!"); 
purses [currentPlayer]++; 
System. out.println (players .get (currentPlayer) 


Game 类 最 后 一 个 接口 是 方法 wrongAnswer () ， 做 玩家 答 错 问题 后 的 事情 : 将 其 关 进 禁 闭 室 ， 选 出 下 一 位 玩家 ， 然 后 返回 true， 表 示 游 戏 仍 在 继续 。 这 个 方法 的 返回 值 虽然 被 客户 端 GameRunner 所 
使 用 ， 但 是 它 永 远 是 true， 让 人 感觉 这 个 返回 值 似乎 没有 存在 的 必要 。 用 一 个 TODO 把 它 记 录 下 来 。 


在 Game 类 中 添加 有 关 wrongAnswer () 方法 的 返回 值 没有 必要 的 TODO 如 下 所 示 (CM: Added TODO: The return value of method Game.wrongAnswer () is unnecessary and should be 


eliminated.) : 


public class Game { 


currentPlayer++; 
if (currentPlayer == players.size()) currentPlayer = 0; 
+ // TODO: The return value of method Game.wrongAnswer() is unnecessary 


and should be eliminated 
return true; 


闻 到 了 一 些 服务 端的 代码 Game 类 中 的 代码 “ 腐 臭 ”后 ， 现 在 可 以 闻 闻 客户 端的 代码 GameRunner 类 中 是 否 也 有 “ 腐 臭 ”。 


“既然 Game 类 的 wrongAnswer () 和 wasCorrectlyAnswered () 方法 都 返回 游戏 是 否 仍 在 继续 ， 那 么 GameRunner 类 中 的 notAWinner 成 员 变量 也 就 可 以 更 名 为 jsGameStilllnProgress。” 


对 。 不 过 咱们 这 次 操练 的 重点 是 重 构 服务 端 代码 Game 类 。 而 且 一 般 客户 端的 代码 都 在 用 户 的 计算 机 上 ， 程 序 员 也 无 法 访问 到 。 所 以 客户 端的 代码 “ 腐 臭 ”在 本 次 操练 中 可 以 暂时 不 管 。 


现在 基本 上 把 代码 通读 了 一 遍 ， 同 时 把 所 遇见 的 代码 “ 腐 自 ”都 写成 了 TODO。 再 看 看 还 有 什么 “ 腐 自 ”遗漏 了 。 
“Game 类 中 的 那些 成 员 变 量 的 访问 权限 最 好 都 改 为 private， 而 不 要 是 default。 改 为 private 封 装 性 更 好 一 些 。" 


在 Game 类 中 添加 有 关 把 成 员 变 量 的 访问 权限 改 为 private 的 TODO 如 下 所 示 (CM: Added TODO: The fields of class Game should be private.) : 


public class Game { 

+ // TODO: The fields of class Game should be private 
ArrayList players = new ArrayList (); 
int[] places = new int[6]; 
int[] purses = new int[6]; 


“还 有 ，Game 类 中 的 roll () 方法 的 参数 roll， 表 示 的 是 掷 色 子 的 点 数 。 最 好 能 改 个 更 确切 的 名 字 ， 比 如 叫 rollingNumber， 而 不 要 和 这 个 方法 的 名 字 相 同 ， 容 易 混 淆 。” 


在 Game 类 的 roll () 方法 中 添加 有 关 把 参数 roll 改 名 的 TODO 如 下 所 示 (CM: Added TODO: Rename the name of the parameter of method Game.roll () to be'rollingNumber'.) : 


public class Game { 


+ // TODO: Rename the name of the parameter of method Game.roll() to be 'rollingNumber' 
public void roll(int roll) { 
System.out.println (players.get (currentPlayer) + " is the current player"); 
System.out.println ("They have rolled a " + roll); 


“好 了 ， 现 在 暂时 间 不 到 其 他 BR T.” 


读 完 了 代码 ， 写 好 了 TODO， 下 一 步 就 开始 编写 测试 来 固化 代码 现 有 行为 ， 以 便 进 行 重 构 了 。 不 过 在 写 测试 前 ， 让 我 们 看 看 本 章 都 做 了 哪些 


1) 阅读 答题 韶关 游戏 Trivia 的 已 有 烂 代 码 。 


2) 在 阅读 代码 的 过 程 中 ， 因 尚未 编写 测试 以 固化 现 有 代码 的 行为 ， 所 以 对 随时 发 现 的 代码 “ 腐 臭 ” 暂 不 做 修改 ， 而 是 以 TODO 注 释 的 形式 添加 到 源 代码 相应 的 位 置 中 ， 待 将 来 写 好 测试 后 再 做 处 理 。 


3) 阅读 代码 时 发 现 了 以 下 代码 “ 腐 自 ”: 
a) Lazy Class% ( 见 createRockQuestion () 方法 ) 。 


b) Speculative Generality 夺 夸 其 谈 未 来 性 ( 见 isPlayable () 方法 和 add () 方法 ) 。 


System.out.printin () 打印 调试 信息 。 


c) 


d) 没有 必要 的 〈 即 无 客户 端 调用 的 ) 宽 接 口 ( 见 howManyPlayers () 方法 ) 


e) Duplicated Code 重 复 代 码 ( 见 roll () 方法 和 wasCorrectlyAnswered () 方法 ) 。 


f) boolean 取 值 与 其 所 表达 语义 的 真 值 相 反 ( 见 wasCorrectlyAnswered () 方法 ) 。 
9) 没有 必要 的 default 访 问 权限 的 成 员 变 量 ( 见 Game 类 中 所 有 成 员 变 量 ) 。 
h) 词 不 达意 的 变量 名 ( 见 roll () 方法 的 参数 ) 。 


4) 对 于 客户 端 代码 的 “ 腐 臭 ” 暂 不 做 修改 。 


5) 通过 操练 我 们 学 到 了 以 下 技能 : 


a) 所 有 程序 员 ， 不 管 是 高 手 还 是 新 手 ， 每 天 都 会 面 对 烂 代码 的 “ 腐 臭 ”。 


b) 在 对 代码 做 重 构 之 前 ， 必 须 针对 要 重 构 的 代码 编写 测试 。 没 有 测试 保护 的 代码 修改 不 能 叫 重 构 ， 而 只 能 叫 “ 裸 奔 ”。 


c) 阅读 代码 时 ， 可 以 把 代码 的 公共 方法 看 成 图 书 中 的 章节 ， 并 将 其 作为 指引 ， 来 阅读 代码 。 


1] 没有 测试 保护 的 代码 修改 就 是 “裸奔 ”， 这 个 说 法 来 自 软 件 开发 顾问 申 健 的 新 浪 微 博 @ 申 导 。 

2] 参见 : https://leanpub.com/codingdojohandbook 

3] 参见 : https://github.com/emilybache/trivia 

4] Trivia 操 练 题目 原 有 代码 参见 : https://github.com/wubin28/tbe-trivia-java/tree/exercise; 本 书 针对 该 题目 的 操练 步骤 代码 参见 : https://github.com/wubin28/tbe-trivia-java/tree/ master. 
5] 为 节省 篇 幅 ， 这 里 和 以 后 的 代码 都 省 略 了 package 和 import 语 句 。 

6] 这 里 列 出 的 代码 主要 供 以 后 参考 ， 可 以 粗略 看 一 下 。 后 面 将 讨论 如 何 阅 读 这 段 代码 。 

[7] 即 《 重 构 》 一 书 中 所 列 出 的 22 种 代码 “ 腐 臭 ”。 


第 12 章 ”用 测试 描绘 用 户 意图 


虽然 从 操练 的 角度 看 ， 咱 们 仅仅 为 了 练习 而 驯服 Trivia 游 戏 的 烂 代码 的 确 无 可 厚 非 ， 但 是 从 商业 价值 的 角度 考虑 ， 如 果 没 有 在 烂 代码 上 修复 bug 或 增添 新 功能 的 需求 ， 而 仅仅 为 了 驯服 烂 代码 而 驯服 的 
话 ， 那 就 是 浪费 。 这 一 点 在 前 面 有 关 烂 代码 的 第 二 条 特性 中 讲 过 。 所 以 ， 为 了 让 这 个 操练 离 现 实情 况 更 近 一 些 ， 咱 们 不 妨 增加 一 个 新 特性 ， 并 蔡 换 掉 原先 的 一 个 旧 特 性 。 即 将 “ 若 玩家 正在 被 关 禁 闭 且 所 掷 
的 点 数 是 偶数 的 ， 那 么 该 玩家 继续 被 关 禁 闭 ” 改 为 “ 若 玩家 正在 被 关 禁 闭 且 所 掷 的 点 数 是 4 时 ， 那 么 该 玩家 继续 被 关 禁 闭 ”。 换 名 话说， 正在 被 关 禁 闭 的 玩家 若 掷 出 了 除 4 之 外 的 任何 点 数 ， 都 会 被 从 禁闭 室 
里 释放 出 来 。 


在 实现 这 个 新 特性 前 ， 需 要 编写 测试 ， 来 为 将 来 的 重 构 和 编写 新 特性 做 准备 。 第 一 个 测试 该 测 什么 呢 ? 


' 我 看 可 以 把 Game 类 的 那些 公共 接口 一 个 一 个 都 测 一 遍 。 比 如 可 以 测 Game 类 的 构造 器 、add () 方法 、roll () 方法 、wasCorrectlyAnswered () 方法 和 wrongAnswer () 方法 。 第 一 个 测试 可 以 
测 Game 类 的 构造 器 。 " 


这 种 测试 的 策略 看 起 来 似乎 很 全 面 ， 但 有 一 个 比较 大 的 问题 。 在 讨论 这 个 问题 之 前 ， 咱 们 先 回 忆 一 下 软件 设计 原则 中 的 依赖 倒置 原则 说 的 是 什么 来 着 ? 


“ 原 话 记 不 起 来 了 ， 但 大 意 是 要 针对 抽象 编程 。 让 我 翻 一 翻 Bob 大 叔 的 书 查 查 啊 。 找 到 了 ， 在 这 里 。 依 赖 倒置 原则 有 两 点 内 容 ， 一 是 高 层 模块 不 应 该 依赖 于 低层 模块 ， 两 者 都 应 该 依赖 于 抽象 ;二 是 抽 
和 象 不 应 该 依赖 于 细节 ， 细 节 应 该 依赖 于 抽象 。[] 


既然 良好 的 设计 原则 讲究 写 代码 需要 针对 抽象 编程 ， 而 不 是 针对 具体 实现 编程 ， 那 么 同样 是 代码 的 测试 代码 ， 也 应 该 针对 用 户 意 图 和 公共 接口 这 样 的 抽象 来 编写 ， 而 不 要 针对 具体 代码 实现 编写 。 因 为 
抽象 的 变动 要 比 具体 实现 的 变动 小 很 多 。 而 针对 抽象 编写 的 测试 才 不 会 那么 脆弱 。 前 面 那 个 根据 User story 来 编写 TDD 测 试 的 酒店 世界 时 钟 的 编程 操练 ， 也 是 这 个 思路 ， 因 为 User Story 一 般 都 描述 了 用 户 


意图 。 


构造 器 的 测试 一 般 要 验证 一 个 类 的 对 象 的 构造 是 否 符合 预期 ， 但 这 事 应 该 属于 该 类 自己 的 内 部 实现 ， 用 户 很 少 会 去 关心 。 如 果 将 测试 耦合 到 构造 器 的 具体 实现 ， 那 么 一 方面 需要 添加 一 些 诸如 反射 、 
Mock 这 些 额外 代码 来 验证 这 些 内 部 实现 ， 增 加 了 编写 测试 的 成 本 和 代码 复杂 性 ， 另 一 方面 一 旦 这 个 内 部 实现 发 生 了 变更 ， 这 个 测试 就 势必 运行 失败 ， 同 时 所 有 上 述 与 其 相关 的 额外 代码 都 要 进行 修改 ,使 
得 这 个 测试 很 脆弱 ， 也 增 大 了 维护 测试 的 成 本 。 


“但 如 果 测试 不 去 验证 这 些 接口 方法 的 内 部 行为 ， 那 该 测 什么 呢 ?” 


， 即 用 户 意图 。 好 比 您 是 使 用 Game 类 的 用 户 ， 您 希望 用 了 这 个 类 后 ， 它 能 为 您 做 什么 有 价值 的 事情 呢 ? 


测试 从 用 户 角度 所 看 到 的 代码 总 


[cs 


[ 


答 问题 、 赢 金币 、 关 禁闭 ， 还 有 最 后 游戏 能 结束 。 


回 


户 当然 希望 Trivia 这 个 游戏 能 顺利 地 玩 下 去 。 比 如 能 添加 玩家 、 掷 色 子 、 在 游戏 盘 上 前 进 、 


户 意图 相 比 实现 意图 来 说 ， 哪 个 更 不 容易 变化 呢 ? 


很 好 呀 ! 这 些 事情 就 是 代码 背后 的 用 户 意图 。 而 Game 类 的 每 个 接口 内 部 的 行为 ， 其 实 是 代码 的 实现 意 


im 


“当然 是 用 户 意图 不 容易 变化 。” 


对 。 这 里 的 用 户 意图 有 点 接口 的 意思 。 编 程 讲究 针对 接口 来 进行 ， 那 么 相应 地 ， 测 试 就 要 讲究 针对 用 户 意图 来 进行 。 这 样 才能 达到 高 内 聚 、 低 耦合 的 目标 。 


[ 
[ 


网 


“可 是 有 时 候 我 见 到 的 用 户 ， 除 了 谈 他 要 的 意图 之 外 ， 还 和 我 说 了 一 大 堆 如 何 实现 的 具体 技术 。 这 些 具 体 实现 的 技术 算 用 户 意 图 吗 ?“ 


网 


IR] 


。 明 智 的 用 户 ， 应 该 只 专注 于 描述 用 户 使 用 层面 的 意 


网 


， 仅 仅 指 不 关心 技术 的 用 户 从 使 用 产品 的 角度 所 提出 的 意图 ， 而 不 包含 实现 该 意图 的 技术 等 其 他 意 


这 个 问题 很 好 。 咱 们 这 里 所 说 的 用 户 意 
而 不 应 染指 程序 员 对 编程 技术 的 选择 。 


“现在 用 户 也 不 在 身边 ， 只 有 咱们 这 两 个 程序 员 。 前 面 阅读 的 代码 也 只 是 实现 层面 的 内 容 ， 那 又 如 何 去 确 定 用 户 意 图 呢 ?“ 


p 


虽然 咱 俩 不 是 真正 意义 上 的 用 户 ， 但 不 妨 戴 上 用 户 这 顶 “思考 帽 ”四 ， 想 想 要 是 自己 是 用 户 的 话 ， 能 有 什么 用 户 意图 呢 ? 


网 


可 以 先 从 最 简单 的 用 户 意 


开始 。 我 现在 能 想到 的 最 简单 的 第 1 个 用 户 意 


网 


， 是 这 个 游戏 只 有 一 个 玩家 ， 他 掷 了 6 次 色 子 并 正确 回答 了 6 次 问题 ， 那 么 游戏 在 6 次 掷 色 子 后 就 能 结束 。 


“要 是 回答 问题 出 错 呢 ?” 


那 就 可 以 想 出 答题 出 错时 最 简单 的 第 2 个 用 户 意图 ， 即 还 是 这 个 玩家 ， 他 第 1 次 掷 色 子 后 回答 问题 就 答 错 了 ， 从 而 被 关 禁 闭 。 但 接 下 来 下 一 次 掷 色 子 的 点 数 是 奇数 ， 从 而 能 够 去 答题 ， 且 答题 正确 。 再 接 
下 来 的 5 次 掷 色 子 回答 问题 他 都 答对 了 ， 那 么 游戏 在 7 次 掷 色 子 后 就 能 结束 。 


[ 


“要 是 被 关 禁 闭 后 下 一 次 掷 色 子 是 偶数 呢 ?“ 


这 就 是 第 3 个 用 户 意图 ， 即 这 个 玩家 ， 第 1 次 掷 色 子 回答 问题 答 错 被 关 禁 闭 ， 接 下 来 下 一 次 掷 色 子 是 偶数 ， 所 以 系统 将 不 关心 他 这 次 掷 色 子 之 后 的 回答 问题 的 正确 与 否 。 再 接 下 来 的 6 次 掷 色 子 回 答 问题 
他 又 都 答对 了 ， 那 么 游戏 在 8 次 掷 色 子 后 结束 。 


[ 


在 GameTest 测 试 类 中 添加 有 关 3 个 用 户 意图 测试 的 TODO 如 下 所 示 (CM: Added 3 user intent tests as TODOs[3].) : 


[ 


public class GameTest { 


+  // TODO-user-intent: the game should be over if a player rolls the dice and 
answers each question correctly for 6 times 

+  // TODO-user-intent: the game should be over if a player rolls the dice for 7 
times and answers the question wrongly for 1 time followed by an odd 
rolling number but then correctly for 6 times 

+  // TODO-user-intent: the game should be over if a player rolls the dice for 8 
times and answers the question wrongly for 1 time followed by an even 
rolling number but then correctly for 7 times 


现在 就 可 以 根据 上 面 第 1 个 用 户 意图 来 编写 测试 ， 即 一 个 用 户 掷 6 次 色 子 上 且 6 次 答题 全 对 。 测 试 代码 如 下 所 示 (CM: Added user intent test 


the_game_should_be _ over if a player rolls the_dice_and_answers_each_question_correctly for 6 times () .Ran it and it passed.) : 


@Test 
public void the game should be over if a player_rolls the dice _and_answers_ 
each question correctly for 6 times() { 
// Arrange 
Game game = new Game(); 
game.add ("Chet"); 
boolean isGameStillInProgress = true; 
// Act 
for (int i = 0; i < 6; i++) { 
game.roll(1); 
isGameStillInProgress = game.wasCorrectlyAnswered () ; 


} 
// Assert 
assertFalse (isGameStillInProgress); 


上 面 代码 中 的 最 后 一 行 assertFalse () 代码 ， 如 果 写 成 assertTrue () 也 可 以 。 因 为 咱们 是 针对 已 有 的 生产 代码 写 测试 ， 所 以 重点 要 看 这 个 测试 实际 运行 后 的 结果 ， 再 根据 实际 结果 调整 这 条 语句 和 测 


试 。 这 种 根据 测试 的 实际 运行 结果 来 编写 测试 的 方法 叫做 特征 测试 内 (characterization test) 。 


上 面 测 试 代 码 实际 运行 的 结果 是 运行 通过 ， 而 且 assertFalse () 语句 也 符合 这 个 测试 所 对 应 的 用 户 意图 ， 所 以 就 不 再 对 上 面 的 代码 进行 调整 了 。 


网 


第 2 个 用 户 意图 是 首次 答题 错误 但 接 下 来 掷 色 子 获得 了 奇数 的 点 数 ， 且 以 后 答题 全 部 正确 ， 其 测试 代码 如 下 所 示 (CM: Added user intent test 


the game _should be over if_a_player_rolls the dice for 7 times and answers the question wrongly for 1 time followed by an_odd rolling number but then_correctly for 6 times () .Ran 


it and it passed.) : 


@Test 
public void the game should be over if a player rolls the dice for 7 times 
and answers the question wrongly for 1 time followed by an odd rolling 
number but then correctly for 6 times() { 
// Arrange aan 
Game game = new Game(); 
game.add ("Chet"); 
boolean isGameStillInProgress = true; 
// Bet 
game.roll (1); 
game .wrongAnswer () ; 
game.roll(1); 
game .wasCorrectlyAnswered () ; 
for (int i = 0; i < 5; i++) { 
game.roll(1); 
isGameStillInProgress = game.wasCorrectlyAnswered () ; 


} 
// Assert 
assertFalse (isGameStillInProgress) ; 


个 用 户 


R] 


意图 是 首次 答题 错误 但 接 下 来 掷 色 子 获得 了 偶数 的 点 数 ， 但 以 后 答题 全 部 正确 ， 其 测试 代码 如 下 所 示 (CM: Added user intent test 


the_game_should_be _ over if a player rolls the dice for 8 times and _ answers the _ question wrongly for 1 time followed by an even rolling number but then_correctly for 7 times with_o 
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it and it passed.) : 


@Test 
public void the game should be over if a player rolls the dice for 8 times_ 
and answers the question wrongly for 1 time followed by an even rolling 
number but then correctly for 7 times with odd rolling numbers() { 
// Arrange ~ aw = > = > 
Game game = new Game (); 
game.add ("Chet"); 
boolean isGameStillInProgress = true; 
// Act 
game.roll (1); 
game .wrongAnswer () ; 
game.roll (2); 
game .wasCorrectlyAnswered () ; 
for (int i = 0; i < 6; i++) { 
game.roll(1); 
isGameStillInProgress = game.wasCorrectlyAnswered () ; 


// Assert 
assertFalse (isGameStillInProgress) ; 


在 编写 了 这 3 个 用 户 意图 测试 并 运行 通过 后 ， 生 产 代码 的 行为 就 会 被 测试 所 固化 。 其 结果 就 是 一 旦 接 下 来 对 生产 代码 所 做 的 改动 破坏 了 上 面 其 所 固化 的 软件 行为 ， 测 试 就 会 运行 失败 。 程 序 员 就 可 以 利 
频繁 运行 自动 化 测试 这 一 点 ， 来 确保 接 下 来 对 生产 代码 所 做 的 重 构 ， 不 会 破坏 那些 已 被 固化 的 行为 。 


“有 了 这 3 个 测试 的 保护 ， 咱 们 就 可 以 放心 地 对 付 前 面 写 的 那些 代码 “' 腐 臭 ”的 TODO 了 。“ 


对 。Game 类 现在 已 经 有 14 个 TODO 了 。 咱 们 可 以 按照 这 些 TODO 在 代码 中 出 现 的 先后 顺序 一 个 一 个 地 解决 。 


在 IDEA 中 的 Game 类 中 的 14 个 TODO 如 图 12-1 所 示 。 


Found 16 TODO items in 2 files 


t = gna SIRA 
z y © kata.trivia (16 items in 2 files) 
+ = Game.ja 
? m (7, 8) // TODO: The fields of class Game should be private 


(26, 16) // TODO: Inline method Game. createRockQuestionO 

(31, 8) // TODO: Change method Game. createRockQuestion( to be private 

(36, 8) // TODO: Remove the unused method Game.isPlayableQ 

(41, 8) // TODO: The return value of method Game. add0O is not used. 

(50, 12) / TODO: Replace System. out.printInO with a log method of a logger 

(56, 8) // TODO: The method Game. howManyPlayers0 should be private because it is only used by its own calss Game 
(61, 8) // TODO: Rename the name of the parameter of method Game.roll0 to be ‘rollingNumber’ 

(86, 16) / TODO: Duplicate code in method Game.roll0 

(134, 20) // TODO: Rename variable ‘winner’ to be ‘isGameStillinProgress’. 

= (141, 20) // TODO: Duplicate code in method Game. wasCorrectlyAnswered(. Inner. 

=| (150, 16) // TODO: Duplicate code in method Game. wasCorrectlyAnswered(. Outer. 

(173, 12) / TODO: The return value of method Game. wrongAnswer() is unnecessary and should be eliminated 
(178, 8) // TODO: The name of the method Game. didPlayerWin0 should be Game.isGameStillinProgress0 


a a) (i) 


图 12-1 Game 类 的 14 个 TODO 
“第 1 个 TODO 是 The fields of class Game should be private。 这 个 TODO 要 求 把 Game 类 的 所 有 成 员 变 量 的 访问 权限 都 改 为 private 的 。” 


完成 有 关 Game 类 的 成 员 变 量 应 该 是 private 的 TODO 的 代码 如 下 所 示 (CM: Finished TODO: The fields of class Game should be private.) : 


public class Game { 
// TODO: The fields of class Game should be private 
ArrayList players = new ArrayList (); 
int[] places = new int[6]; 
int[] purses = new int[6]; 
boolean[] inPenaltyBox = new boolean[6]; 


LinkedList popQuestions = new LinkedList (); 
LinkedList scienceQuestions = new LinkedList (); 
LinkedList sportsQuestions = new LinkedList (); 
LinkedList rockQuestions = new LinkedList (); 


int currentPlayer = 0; 

boolean isGettingOutOfPenaltyBox; 

private ArrayList players = new ArrayList (); 
private int[] places = new int[6]; 

private int[] purses = new int[6]; 

private boolean[] inPenaltyBox = new boolean[6]; 


private LinkedList popQuestions = new LinkedList (); 
private LinkedList scienceQuestions = new LinkedList (); 
private LinkedList sportsQuestions = new LinkedList (); 
private LinkedList rockQuestions = new LinkedList (); 


private int currentPlayer = 0; 
private boolean isGettingOutOfPenaltyBox; 
public Game() { 

for (int i = 0; i < 50; i++) { 


a) 


改 完 代 码 后 ， 别 忘 了 运行 测试 。 测 试 运行 通过 。 
“把 createRockQuestion () 方法 inline 能 够 解决 接 下 来 的 两 个 TODO。" 


完成 Game 类 中 有 关 createRockQuestion () 方法 的 两 个 TODO 的 代码 如 下 所 示 (CM: Inlined a method and finished 2: 1) Change method Game.createRockQuestion () to be private; 
2 


> 


Inline method Game.createRockQuestion () .) : 


public class Game { 
scienceQuestions.addLast ( ("Science Question " + i)); 
sportsQuestions.addLast ( ("Sports Question " + i)); 

= // TODO: Inline method Game.createRockQuestion () 

= rockQuestions.addLast (createRockQuestion (i) ) 7 
rockQuestions.addLast ("Rock Question " + i); 


// TODO: Change method Game.createRockQuestion() to be private 
public String createRockQuestion(int index) { 
return "Rock Question " + index; 


运行 测试 ， 通 过 。 


“删除 目前 没 用 的 isPlayable () 方法 这 个 TODO 也 很 简单 。” 


完成 删除 Game 类 的 isPlayable () 方法 的 TODO 代 码 如 下 所 示 (CM: Finished TODO: Remove the unused method Game.isPlayable () .) : 


public class Game { 
= // TODO: Remove the unused method Game.isPlayable () 
public boolean isPlayable() { 

return (howManyPlayers() >= 2); 


运行 测试 ， 通 过 。 


“ 接 下 来 解决 The return value of method Game.add () is not used. 这 个 TODO。 ” 


且慢 ， 解 决 这 个 TODO 就 势必 要 改变 Game 类 的 这 个 公共 接口 的 返回 值 。 由 于 这 个 公共 接口 已 经 被 客户 端 所 调用 了 ， 所 以 对 其 所 做 的 任何 改动 都 要 十 分 谨慎 。 虽 然 对 于 这 个 题目 咱们 可 以 确信 那个 有 
main () 方法 的 客户 端 没 有 调用 这 个 方法 ， 但 我 还 是 宁愿 把 这 个 TODO 放 到 最 后 来 做 。 在 实际 工作 中 ， 这 种 对 服务 端的 公共 接口 的 改动 ， 也 需要 尽量 往 后 放 一 放 ， 以 便 有 时 间 来 确信 这 种 改动 对 客户 端的 影 
响 在 可 控 范 围 内。 


“ 那 就 把 这 个 TODO 标 记 为 later， 表 示 以 后 再 处 理 。 


将 有 关 Game 类 的 add () 方法 的 TODO 标 记 为 later 的 代码 如 下 所 示 (CM: Mark this TODO to handle it later: The return value of method Game.add () is not used.) : 


一 // TODO: The return value of method Game.add() is not used. 
+ // TODO-later: The return value of method Game.add() is not used. 


“下 一 个 把 System.out.println () 替换 为 log 方 法 的 TODO 由 于 工作 量 相对 较 大 ， 也 标记 为 laterf 吧 。"” 


将 Game 类 的 有 关 System.out.println () 的 TODO 标 记 为 later 的 代码 如 下 所 示 (CM: Mark this TODO to handle it later: Replace System.out.println () with a log method of a logger.) : 


= // TODO: Replace System.out.println() with a log method of a logger 
+ // TODO-later: Replace System.out.println() with a log method of a logger 


“下 一 个 TODO 是 把 howManyPlayers () 方法 改 为 private 的 。 不 像 前 面 那样 ， 这 个 方法 没有 被 客户 端 所 调用 ， 所 以 就 可 以 比较 放心 地 将 其 由 public 改 为 private。” 


完成 Game 类 有 关 howManyPlayers () 方法 的 TODO 的 代码 如 下 (CM: Finished TODO: The method Game.howManyPlayers () should be private because it is only used by its own class 


Game.) : 


public class Game { 


- // TODO: The method Game.howManyPlayers() should be private because it is 
only used by its own calss Game 
一 public int howManyPlayers() { 
+ private int howManyPlayers() { 
return players.size(); 


“下 一 个 TODO 是 把 roll () 方法 的 参数 roll 改 名 为 rollingNumber， 这 个 改动 用 IDEA 的 rename 重 构 功 能 就 能 轻松 完成 。” 


完成 Game 类 有 关 roll () 方法 的 参数 改名 的 TODO 的 代码 如 下 所 示 (CM: Finished TODO: Rename the name of the parameter of method Game.roll () to be'rollingNumber'.) : 


kag // TODO: Rename the name of the parameter of method Game.roll() to be 'rollingNumber' 
= public void roll (int roll) { 
+ public void roll(int rollingNumber) { 


System.out.println ("They have rolled a " + roll); 
+ System.out.println ("They have rolled a " + rollingNumber) ; 


if (roll % 2 != 0) { 
+ if (rollingNumber % 2 != 0) { 


一 places [currentPlayer] 
+ places [currentPlayer] 


places[currentPlayer] + roll; 
places[currentPlayer] + rollingNumber; 


= places [currentPlayer] places[currentPlayer] + roll; 


+ places [currentPlayer] = places[currentPlayer] + rollingNumber; 
运行 测试 ， 通 过 。 


“下 一 个 TODO 是 roll () 方法 里 的 


复 代 码 ， 这 可 以 通过 提取 方法 currentPlayerMovesToNewPlaceAndAnswersAQuestion () 来 解决 。” 


完成 Game 类 有 关 roll () 方法 中 


in method Game.roll () .) : 


复 代 码 的 TODO 的 代码 如 下 所 示 (CM: Extracted method currentPlayerMovesToNewPlaceAndAnswersAQuestion () and finished TODO: Duplicate code 


public class Game { 


= places[currentPlayer] = places[currentPlayer] + rollingNumber; 
= if (places[currentPlayer] > 11) places[currentPlayer] = 
places[currentPlayer] - 12; 


= System. out.println (players .get (currentPlayer) 
7 + "'s new location is " 
一 + places [currentPlayer])7 
- System.out.println("The category is " + currentCategory()); 
一 askQuestion (); 
+ currentPlayerMovesToNewPlaceAndAnswersAQuestion (rollingNumber) ; 
} else { 
System.out.println(players.get (currentPlayer) + " is not 
getting out of the penalty box"); 
isGettingOutOfPenaltyBox = false; 
} 
} else { 
+ currentPlayerMovesToNewPlaceAndAnswersAQuestion (rollingNumber) ; 
+ } 
= // TODO: Duplicate code in method Game.roll() 
= places[currentPlayer] = places[currentPlayer] + rollingNumber; 
- if (places[currentPlayer] > 11) places[currentPlayer] = 
places[currentPlayer] - 12; 
= System.out.Println (players .get (currentPlayer) 
= + "'s new location is " 
一 + places [currentPlayer]) 7 
- System.out.println("The category is " + currentCategory()); 
= askQuestion (); 
= } 
+ } 
+ private void currentPlayerMovesToNewPlaceAndAnswersAQuestion (int rollingNumber) { 
+ places [currentPlayer] = places[currentPlayer] + rollingNumber; 
+ if (places[currentPlayer] > 11) places[currentPlayer] = 
places[currentPlayer] - 12; 
+ System. out.println (players .get (currentPlayer) 
+ + "'s new location is " 
+ + places [currentPlayer]); 
+ System.out.println("The category is " + currentCategory()); 
+ askQuestion () ; 


= // TODO: Rename variable 'winner' to be 'isGameStillInProgress'. 
= boolean winner = didPlayerWin(); 
+ boolean isGameStillInProgress = didPlayerWin(); 


7 return winner; 


“ 接 下 来 的 TODO 是 wasCorrectlyAnswered () 方法 内 


完成 Game 类 有 关 wasCorrectlyAnswered () 方法 中 内 半 


return isGameStillInProgress; 


boolean winner = didPlayerWin(); 
boolean isGameStillInProgress = didPlayerWin(); 


return winner; 
return isGameStillInProgress; 


Game.wasCorrectlyAnswered () .Inner.) : 


public class Game { 


十 十 十 十 十 


十 


+ " Gold Coins."); 
boolean isGameStillInProgress = didPlayerWin(); 
currentPlayert+; 
if (currentPlayer == players.size()) currentPlayer = 0; 
nextPlayer (); 
return isGameStillInProgress; 
} else { 


屋 的 重复 代码 ， 可 以 通过 提取 方法 nextPlayer () 来 解决 。” 


// TODO: Duplicate code in method Game.wasCorrectlyAnswered(). Inner. 


currentPlayert+; 

if (currentPlayer == players.size()) currentPlayer = 0; 
nextPlayer (); 

return true; 


+ " Gold Coins."); 
boolean isGameStillInProgress = didPlayerWin (); 
currentPlayert+; 
if (currentPlayer == players.size()) currentPlayer = 0; 
nextPlayer () 7 
return isGameStillInProgress; 
} 
} 
private void nextPlayer() { 
currentPlayert+; 
if (currentPlayer == players.size()) currentPlayer = 0; 


} 


public boolean wrongAnswer() { 
System.out.println ("Question was incorrectly answered"); 


System.out .Println (players.get (currentPlayer) + " was sent to the penalty box"); 


inPenaltyBox[currentPlayer] = true; 

currentPlayert+; 

if (currentPlayer == players.size()) currentPlayer = 0; 
nextPlayer (); 


复 代码 的 TODO 的 代码 如 下 所 示 (CM: Extracted method nextPlayer () and finished TODO: Duplicate code in method 


运行 


“ 接 下 来 该 解决 wasCorrectlyAnswered () 方法 的 外 


测试 ， 通 过 。 


代码 了 。” 


这 个 外 层 的 重复 代码 有 一 个 笔 误 : correct 被 误 写 为 corrent。 这 个 笔 误 给 予 我 们 两 点 启示 。 首 先 ， 用 复制 粘贴 的 方法 生成 寻 


一 致 ， 从 而 增 大 了 消除 重复 代码 的 难度 。 另 外 ， 要 消 代码 ， 必 须 先 把 两 段 或 多 段 重 
“好 的 。 下 面 就 把 这 个 笔 误 改过 来 ， 使 得 两 段 重复 代码 完全 相同 。” 


复 代码 后 ， 随 着 时 间 的 推移 ， 


代码 恢复 成 相互 之 间 完 全 相同 的 状态 。 


复 的 代码 会 发 生 一 些 变化 ， 与 原来 的 代码 不 


代码 还 原 为 完全 一 致 的 代码 如 下 所 示 (CM: Corrected a typo to make sure the duplicate code is exactly the same before extracting a method.) : 


System.out .Println ("Answer was corrent!!!!"); 
System.out.println ("Answer was correct!!!!"); 


“ 改 好 了 笔 误 ， 就 可 以 解决 wasCorrectlyAnswered () 方法 的 外 层 重 复 代 码 了 。 可 以 通过 提取 currentPlayerGetsAGoldCoinAndSelectNextPlayer() 方法 来 消除 这 两 


复 代 码 。” 


完成 Game 类 有 关 wasCorrectlyAnswered () 方法 的 外 层 重 复 代码 的 TODO 的 代码 如 下 所 示 (CM: Extracted method currentPlayerGetsAGoldCoinAndSelectNextPlayer () and finished 


TODO: Duplicate code in method Game.wasCorrectlyAnswered () .Outer.) : 


public class Game { 


+++++++++1 


public boolean wasCorrectlyAnswered() { 
if (inPenaltyBox[currentPlayer]) { 
if (isGettingOutOfPenaltyBox) { 
System.out.println ("Answer was correct!!!!"); 
purses [currentPlayer]++; 
System. out.println (players .get (currentPlayer) 
+ " now has " 
+ purses [currentPlayer] 
+ " Gold Coins."); 


boolean isGameStillInProgress = didPlayerWin (); 
nextPlayer (); 


return isGameStillInProgress; 

return currentPlayerGetsAGoldCoinAndSelectNextPlayer () ; 
} else { 

nextPlayer (); 

return true; 


} else { 
return currentPlayerGetsAGoldCoinAndSelectNextPlayer () ; 
} 


// TODO: Duplicate code in method Game.wasCorrectlyAnswered () . 


System.out.println ("Answer was correct!!!!"); 
purses [currentPlayer]++; 
System. out.println (players .get (currentPlayer) 
+" now has " 
+ purses [currentPlayer] 
+ " Gold Coins."); 
boolean isGameStillInProgress = didPlayerWin(); 
nextPlayer () 7 
return isGameStillInProgress; 
} 
private boolean currentPlayerGetsAGoldCoinAndSelectNextPlayer() { 
System.out.println ("Answer was correct!!!!"); 
purses [currentPlayer]++; 
System. out.println (players.get (currentPlayer) 
+" now has " 
+ purses [currentPlayer] 
+ " Gold Coins."); 
boolean isGameStillInProgress = didPlayerWin (); 
nextPlayer (); 


Outer. 


+ return isGameStillInProgress; 
} 
private void nextPlayer() { 


“下 一 个 TODO 是 wrongAnswer () 的 那个 没有 存在 必要 的 永远 返回 true 的 返回 值 。 由 于 客户 端正 在 使 用 这 个 返回 值 ， 不 便于 修改 ， 所 以 把 这 个 TODO 标 记 为 later。” 


将 Game 类 有 关 wrongAnswer () 方法 没有 必要 存在 的 返回 值 的 TODO 标 记 为 later 的 代码 如 下 所 示 : 


= // TODO: The return value of method Game.wrongAnswer() is unnecessary 
and should be eliminated 

+ // TODO-later: The return value of method Game.wrongAnswer() is 
unnecessary and should be eliminated 


“最 后 一 个 TODO 是 把 方法 didPlayerWin () 改名 为 isGamestilllnProgress () 。” 


完成 Game 类 有 关 didPlayerWin () 方法 重 命名 的 TODO 的 代码 如 下 所 示 (CM: Finished TODO: The name of the method Game.didPlayerWin () should be 


Game.isGameStilllnProgress () .) : 


1 


boolean isGameStillInProgress = didPlayerWin(); 
+ boolean isGameStillInProgress = isGameStillInProgress () ; 


ty 


// TODO: The name of the method Game.didPlayerWin() should be Game. 
isGameStillInProgress () 

= private boolean didPlayerWin() { 

private boolean isGameStilliInProgress() { 


+ 


运行 测试 ， 通 过 。 现 在 Game 类 剩 下 3 个 later 的 TODO 了 ， 如 


12-2 所 示 。 


运 图 


_ Current File Scope Based | 


=|’ Found 5 TODO items in 2 files 
v © kata.trivia (5 items in 2 files) 
+ = v @ Game.java 
? Œ 29, 8) // TODO-later: The return value of method Game. addQ is not used. 


38, 12) // TODO-later: Replace System. out. printinO with a log method of a logger 
加 | E (143, 12) // TODO-later: The return value of method Game. wrongAnswer( is unnecessary and should be eliminated 
bs | 


> @ GameRunner.java 


图 12-2 Game 类 剩 下 3 个 later 的 TODO 


前 后 两 个 TODO 都 是 被 客户 端 使 用 的 服务 端的 接口 ， 还 是 暂时 放 一 放 。 现 在 可 以 处 理 中 间 那 个 把 System.out.printIn () 替换 成 log 方 法 的 TODO。 在 实际 工作 中 记录 log 比 较 常 用 的 做 法 是 把 log 保 存 到 
文件 中 ， 以 便于 阅读 和 分 享 。 所 以 我 打算 在 这 里 把 System.out.printIn () 所 打印 的 日 志 信 息 都 保存 到 log 文 件 中 。 首 先 需 要 创建 一 个 能 完成 这 个 任务 的 logger。 


完成 Game 类 中 有 关 蔡 换 System.out.println () 方法 的 TODO 的 代码 如 下 所 示 (CM: Finished TODO: Replace System.out.printIn () with a log method of a logger.) : 


+import java.io.IOException; 
+import java.util.logging.FileHandler; 
+import java.util.logging.Logger; 
+import java.util.logging.SimpleFormatter; 
public class Game { 
private ArrayList players = new ArrayList (); 


+ private static Logger logger = Logger.getLogger ("kata.trivia.Game") ; 
+ private static FileHandler fileHandler = null; 
+ 
public Game () { 
+ try { 
+ fileHandler = new FileHandler ("%h/Game-logging.log", 10000000, 1, true); 
+ fileHandler.setFormatter (new SimpleFormatter () ); 
+ } catch (IOException e) { 
+ e.printStackTrace () ; 
+ } 
+ logger .addHandler (fileHandler) ; 


运行 测试 ， 通 过 。 上 面 创建 FileHandler 实 例 的 new FileHandler ("%h/Game-logging.log", 10000000, 1, true) 的 语句 里 面 有 4 个 参数 ， 其 中 第 1 个 参数 %h/Game-logging.log 表 示 日 志文 件 名 是 
Game-logging.log， 并 在 用 户 的 home 目 录 下 被 创建 。 第 2 个 参数 10000000 表 示 每 个 日 志文 件 的 最 大 字 节 数 为 10 兆 字 节 。 第 3 个 参数 1 表示 只 使 用 这 一 个 日 志文 件 。 第 4 个 参数 true 表 示 新 生成 的 日 志 会 被 添 
加 到 日 志文 件 的 尾部 。 


得 到 了 一 个 能 够 写 入 日 志文 件 的 logger， 接 下 来 就 可 以 把 System.out.println () 语句 都 替换 成 logger.info () 语句 ， 这 样 每 一 句 logger.info () 语句 中 的 日 志 都 会 被 记录 到 日 志文 件 中 。 


将 Game 类 中 System.out.println () 方法 替换 为 ogger.info () 方法 的 代码 如 下 所 示 口 ]: 


// TODO-later: Replace System.out.Println() with a log method of a logger 
System.out.println(playerName + " was added"); 
System.out .println ("They are player number " + players.size()); 


++i rd 


logger.info(playerName + " was added"); 
logger.info("They are player number " + players.size()); 
return true; 
} 
public void roll(int rollingNumber) { 
= System.out .Println (players.get (currentPlayer) + " is the current player"); 
= System.out.printl1n ("They have rolled a " + rollingNumber) ; 
+ logger. info (players.get (currentPlayer) + " is the current player"); 
+ logger.info("They have rolled a " + rollingNumber) ; 


运行 测试 ， 通 过 。“ 剩 下 两 个 later 的 TODO 中 ， 上 面 那个 add () 方法 的 返回 值 没 有 被 客户 端 使 用 的 TODO 更 容易 处 理 一 些 。 所 以 现在 就 可 以 去 掉 这 个 返回 值 。” 


完成 Game 类 中 有 关 add () 方法 返回 值 的 TODO 的 代码 如 下 所 示 (CM: Finished TODO: The return value of method Game.add () is not used.) : 


1 


// TODO-later: The return value of method Game.add() is not used. 
- public boolean add(String playerName) { 
public void add(String playerName) { 


p+ 


public void add(String playerName) { 


logger.info(playerName + " was added"); 
logger.info("They are player number " + players.size()); 
= return true; 


运行 测试 ， 通 过 。“ 好 了 ， 除 了 还 剩 下 一 个 以 后 处 理 的 later TODO 外 ， 所 有 与 代码 “ 腐 臭 ”相关 的 TODO 都 已 经 处 理 完了 。 " 


还 有 一 个 味道 很 重 的 代码 “ 腐 臭 ”没有 被 处 理 。 


“是 不 是 《 重 构 》 一 书 中 所 说 的 那个 Large Class ‘gs’ ? " 


没 错 。Trivia 这 个 游戏 的 所 有 事情 都 让 Game 这 一 个 类 来 处 理 ， 这 违反 了 软件 设计 的 单一 职责 原则 和 开 闭 原则 6。 不 过 在 咱们 解决 Large Class 这 个 “ 腐 臭 ”之 前 ， 先 看 看 本 章 所 做 的 工作 。 


1) 根据 用 户 意图 编写 了 3 个 测试 ， 运 行 通过 ， 固 化 代码 已 有 行为 ， 并 以 此 作为 后 面 重 构 的 保护 网 。 


2) 按 TODO 列 表 的 顺序 依次 解决 各 个 TODO 来 进行 重 构 。 


3) 通过 操练 我 们 学 到 了 以 下 技能 : 


a) 测试 的 编写 应 该 面向 相对 稳定 的 用 户 意图 这 个 抽象 ， 而 不 是 面向 相对 易 变 的 已 有 代码 的 具体 实现 。 


b) 首先 编写 表现 用 户 意图 的 测试 ， 并 运行 通过 ， 来 固化 软件 行为 。 然 后 在 其 保护 下 按 在 代码 中 出 现 的 先后 顺序 来 处 理 与 代码 “ 腐 臭 ”相关 的 TODO。 


c 在 重 构 过 程 中 ， 只 要 有 可 能 运行 测试 ， 就 尽量 频繁 地 运行 测试 ， 以 保证 重 构 不 会 破坏 已 被 测试 所 固化 的 软件 行为 。 


d) 在 重 构 过 程 中 需要 修改 那些 已 被 客户 端 所 使 用 的 公共 接口 时 ， 一 定 要 谨慎 ， 可 以 尽量 往 后 放 一 放 ， 以 便 有 时 间 来 确信 这 种 改动 对 客户 端的 影响 是 否 在 可 控 范 围 内 。 


e) 对 于 工作 量 较 大 的 TODO， 可 以 标记 为 later 以 便 以 后 处 理 。 


f) 重复 代码 可 以 通过 方法 提取 来 解决 。 


9) 去 除 重复 代码 的 工作 要 尽早 进行 ， 否 则 随 着 时 间 的 推移 ， 重 复 的 代码 会 发 生 一 些 变化 ， 与 原来 的 代码 不 一 致 ， 从 而 增 大 了 消除 重复 代码 的 难度 。 


h) 要 消除 重复 代码 ， 必 须 先 把 两 段 或 多 段 重复 代码 恢复 成 相互 之 间 完 全 相同 的 状态 。 


i) 把 用 于 日 志 记 录 的 System.out.printIn () 方法 蔡 换 为 loggerinfo () 方法 ， 并 保存 到 日 志文 件 中 ， 便 于 阅读 和 分 享 。 


[1] Robert C.Martin 著 ， 邓 辉 译 ，《 人 敏捷 软件 开发 : 原则 、 模 式 与 实践 》， 清 华 大 学 出 版 社 ，2003 年 9 月 第 1 版 
[2] ALA RAP G#M” > http://baike.baidu.com/view/2634811.htm?fr=aladdin。 

[B] 对 代码 提交 的 Commit Message 的 改进 由 于 git 的 特性 而 无 法 事后 更 改 ， 所 以 本 书 所 列 的 一 些 Commit Message 和 一 些 代码 本 身 会 与 github 上 的 略 有 出 入 ， 以 本 书 内 容 为 准 。 

[4] Michael C.Feathers 著 ， 刘 未 鹏 译 ，《 修 改 代码 的 艺术 》， 人 民 邮 电 出 版 社 ，2007 年 11 月 第 1 版 ， 第 13 章 。 

[5] 为 节省 篇 幅 ， 这 里 仅 列 出 部 分 代码 。 

[0] 单一 职责 原则 SRP (Single-Responsibility Principle) 指 的 是 一 个 类 发 生变 化 的 原因 只 能 有 一 个 ; 开 闭 原则 OCP (Open/Closed Principle) 指 的 是 软件 的 实体 (如 类 、 模 块 和 元 数 等 ) 应 该 对 扩展 开放 ， 对 修改 
关闭 。 参 见 Robert C.Martin 所 著 《敏捷 软 件 开发 : 原则 、 模 式 与 实践 》 一 书 。 


第 13 章 ”分 而 治之 一 一 釜底抽薪 


前 面 处 理 的 包含 重复 代码 在 内 的 那 十 几 个 代码 “ 腐 臭 ”TODO， 为 现在 咱们 处 理 Large Class“ 腐 臭 ” 打 好 了 基础 。 


“对 ， 如 果 不 先 处 理 像 重 复 代 码 这 样 的 代码 “ 腐 臭 ”， 而 是 一 上 来 就 要 把 一 个 大 类 分 解 为 几 个 小 类 ， 一 方面 会 由 于 重复 代码 造成 代码 过 长 而 难以 阅读 ， 从 而 给 分 解 工作 带 来 困难 ， 另 一 方面 分 解 大 类 的 
操作 可 能 会 破坏 重复 代码 相互 之 间 完 全 相同 的 状态 ， 并 有 可 能 让 重复 代码 分 散 到 不 同 的 小 类 中 ， 增 加 后 面 消除 重复 代码 的 难度 。 


没 错 。 现 在 就 可 以 观察 一 下 Game 类 的 代码 ， 看 看 有 哪些 代码 逻辑 可 以 被 分 离 到 新 的 类 中 。 


“Game 类 的 代码 开头 有 两 块 定义 成 员 变 量 的 代码 ， 中 间 被 一 行 空 行 所 分 隔 。 这 两 块 聚 在 一 起 的 成 员 变量 ， 是 不 是 在 暗示 咱们 可 以 把 它们 分 别 放 到 两 个 新 的 类 中 呢 ?“ 


很 好 。 就 如 同 Martin Fowler 在 《 重 构 》 一 书 中 所 说 的 : 数据 项 就 像 小 孩子 ， 喜 欢 成 群 结 队 地 待 在 一 块 儿 。.…… 这 些 总 是 绑 在 一 起 出 现 的 数据 真 应 该 拥有 属于 它们 自己 的 对 象 。 


Game 类 的 代码 开头 两 块 定义 成 员 变 量 的 代码 如 下 : 


public class Game { 
private ArrayList players = new ArrayList (); 
private int[] places = new int[6]; 
private int[] purses = new int[6]; 
private boolean[] inPenaltyBox = new boolean[6]; 
private LinkedList popQuestions = new LinkedList (); 
private LinkedList scienceQuestions = new LinkedList (); 
private LinkedList sportsQuestions = new LinkedList (); 
private LinkedList rockQuestions = new LinkedList (); 


“前 面 一 块 代码 定 义 了 4 个 成 员 变 量 ， 来 分 别 保存 玩家 的 名 字 、 在 游戏 盘 上 的 位 置 、 钱 包 中 的 金币 数量 和 是 否 在 禁闭 室 的 状态 。 这 些 都 和 玩家 相关 ， 所 以 可 以 创建 一 个 新 的 玩家 类 Player， 并 把 这 4 个 成 
员 变 量 移动 到 Player 类 中 。” 


可 以 添加 一 个 TODO 来 记录 这 件 事 。 


在 Game 类 中 添加 将 成 员 变 量 playerName、places、purses 和 inPenaltyBox 移 动 到 新 的 Player 类 的 TODO 中 ， 代 码 如 下 (CM: Added TODO: Move playerName, places, purses and 


inPenaltyBox to a new class Player.) : 


public class Game { 
+ // TODO: Move playerName, places, purses and inPenaltyBox to a new class Player 
private ArrayList players = new ArrayList (); 
private int[] places = new int[6]; 
private int[] purses = new int[6]; 
private boolean[] inPenaltyBox = new boolean[6]; 


“后 面 那 块 代码 定义 了 4 个 有 关 问 题 的 成 员 变 量 ， 


可 以 放 到 一 个 有 关 问 题 的 新 类 中 。” 


对 ， 这 个 新 类 不 妨 叫 QuestionMaker。 


在 Game 类 中 添加 将 成 


arg 
RE 


lists to a new class QuestionMaker.) : 


public class 


+ 


把 有 关 移 动 question list 的 TODO 标 记 为 working-on 并 创建 QuestionMaker 类 ， 代 码 如 下 (CM 


Game { 


// TODO: 
private 
private 
private 
private 


LinkedList 
LinkedList 
LinkedList 
LinkedList 


Move question lists to a new class QuestionMaker 


popQuestions = new LinkedList (); 
scienceQuestions = new LinkedList (); 
sportsQuestions = new LinkedList (); 
rockQuestions = new LinkedList (); 


“上 面 这 两 个 TODO 相 比 起 来 ， 后 一 个 看 起 来 更 简单 一 些 ， 所 以 先 处 理 后 一 个 TODO。” 


QuestionMaker.) : 


public class Game { 


+ 


// TODO: Move question lists to a new class QuestionMaker 


// TODO-working-on: 


Move question lists to a new class QuestionMaker 


+public class QuestionMaker { 
+} 


“ 接 下 来 ， 就 可 以 把 这 4 个 question list 成 员 变 量 移动 到 QuestionMaker 类 中 了 。” 


把 4 个 question list 成 员 变 


public class Game { 


// TODO-working-on: 


private LinkedList 
private LinkedList 
private LinkedList 
private LinkedList 


量 从 Game 类 移动 到 QuestionMaker 类 的 代码 如 下 (CM: 


Move question lists to a new class QuestionMaker 
popQuestions = new LinkedList () 7? 

scienceQuestions = new LinkedList (); 
sportsQuestions = new LinkedList (); 

rockQuestions = new LinkedList (); 


public class QuestionMaker { 


十 十 十 十 十 十 


对 生产 代码 所 做 的 恒 


比 
比 


“现在 咱们 使 
删除 的 地 方 就 会 出 现 编译 错误 。 可 以 利 


// TODO-working-on: 


private LinkedList 
private LinkedList 
private LinkedList 
private LinkedList 


Move question lists to a new class QuestionMaker 
popQuestions = new LinkedList (); 

scienceQuestions = new LinkedList (); 
sportsQuestions = new LinkedList (); 

rockQuestions = new LinkedList (); 


: Working on TODO: 


EMITS 


“釜底抽薪 ”的 方法 适用 于 简单 的 重 构 。 


的 就 是 “ 


类 问题 。” 


将 原先 向 question list 中 添加 问题 


public class Game { 


E a ao a a a | 


在 Game 类 中 创建 成 员 变量 questionMaker 的 代码 如 下 (CM: Created field questionMaker in class Game.) : 


for 


底 抽 薪 ”的 方法 。 按 照 咱们 的 重 构 意 
这 些 编译 错误 的 指引 来 将 原先 向 question list 中 添 


， 在 把 4 个 question 


的 语句 替换 为 QuestionMaker 相 关 的 意 


(int i = 0; i < 50; i++) { 


popQuestions.addLast ("Pop Question " + i); 
scienceQuestions.addLast (("Science Question " + i)); 
sportsQuestions.addLast ( ("Sports Question " + i)); 


新 代码 蔡 换 旧 代码 。 蔡 换 的 方法 可 以 分 为 两 种 : 第 一 种 是 不 保留 旧 代码 ， 而 直 
“釜底抽薪 ”， 从 根本 上 解决 问题 ;第 二 种 是 在 保留 旧 代 码 的 基础 上 ， 在 | 旧 代 码 
“抛砖引玉 ”， 照 着 旧 代 码 这 块 “ 砖 ”编写 新 代码 这 块 “ 玉 ”。 


接 


新 代码 替换 


后 面 编写 新 代码 ， 待 新 代码 编写 完 ， 将 代码 行为 


popQuestions、scienceQuestions、sportsQuestions 和 rockQuestions 移 动 到 新 的 QuestionMaker 类 的 TODO 中 ， 代 码 如 下 (CM: Added TODO: Move question 


Move question lists to a new class QuestionMaker.Created class 


Moved the 4 question lists from class Game to QuestionMaker.) : 


日 代码 ， 并 最 终 保证 原 有 的 测试 在 新 代码 上 也 能 运行 通过 ， 这 种 方法 好 
切换 到 新 代码 后 仍 能 保证 测试 运行 通过 ， 此 时 再 删除 旧 代码 ， 这 种 方法 好 


“抛砖引玉 ”的 方法 适 


于 复杂 一 些 的 重 构 。 


rockQuestions.addLast ("Rock Question " + i); 
questionMaker.addPopQuestion ("Pop Question " + i); 
questionMaker.addScienceQuestion(("Science Question " + i)); 
questionMaker.addSportsQuestion(("Sports Question " + i)); 
questionMaker.addRockQuestion ("Rock Question " + i); 
} 
“上 面 意图 代码 中 的 questionMaker 是 红色 的 ， 表 示 有 编译 错误 。 原 因 是 它们 都 没有 创建 。 应 该 在 Game 类 中 创建 它 。” 


public class Game { 
+ 


“创建 好 了 questionMaker 这 个 成 员 变 


private final QuestionMaker questionMaker 


new QuestionMaker () ; 


， 现 在 上 


区 


list 成 员 变量 从 Game 类 移动 到 QuestionMaker 类 后 ， 在 Game 类 中 利用 这 4 个 成 员 变 量 对 question list 进 行 添加 和 
[问题 的 语句 ， 蔡 换 为 QuestionMaker 相 关 的 意 | 


代码 ， 即 QuestionMaker 类 需要 4 个 添加 问题 的 方法 来 添加 那 4 


代码 ， 如 下 所 示 (CM: Replaced question-adding code with intention code of using QuestionMaker object.) : 


代码 中 的 4 个 添加 问题 的 方法 又 变 成 表示 编程 错误 的 红色 。 这 需要 咱们 创建 这 4 个 方法 。” 


在 QuestionMaker 类 中 创建 4 个 问题 添加 方法 的 代码 如 下 (CM: Created 4 question adding methods in class QuestionMaker.) : 


public class QuestionMaker { 


十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 


public void addPopQuestion (String popQuestion) { 
popQuestions.add (popQuestion); 


} 


public void addScienceQuestion (String scienceQuestion) { 
scienceQuestions.add(scienceQuestion) ; 


} 


public void addSportsQuestion (String sportsQuestion) { 
sportsQuestions.add(sportsQuestion) ; 


} 


public void addRockQuestion (String rockQuestion) { 
rockQuestions.add(rockQuestion) ; 


} 


现在 4 个 问题 添加 方法 已 经 没有 编译 错误 了 。 接 下 来 该 处 理 Game 类 的 askQuestion () 方法 中 的 4 个 问题 删除 方法 的 编译 错误 了 。 不 过 我 忽然 注意 到 ，Game 类 中 的 ArrayList 成 员 变 量 player， 和 
QuestionMaker 类 中 的 那 4 个 LinkedList 成 员 变量 ， 都 不 是 类 型 安全 的 ， 可 以 添加 两 个 TODO 来 分 别 记录 下 来 。 


在 Game 和 QuestionMaker 类 中 添加 两 个 有 关 类 型 安全 的 TODO,， 代码 如 下 (CM: Added 2 TODOs to make question and player lists type-safe.) : 


public class Game { 


+ // TODO: Make player list type-safe 
private ArrayList players = new ArrayList(); 


public class QuestionMaker { 


+ // TODO: Make question lists type-safe 
private LinkedList popQuestions = new LinkedList (); 
private LinkedList scienceQuestions = new LinkedList (); 
private LinkedList sportsQuestions = new LinkedList (); 
private LinkedList rockQuestions = new LinkedList (); 


“ 记 下 这 两 个 TODO 后 ， 下 面 该 处 理 4 个 问题 删除 方法 的 编译 错误 了 。 还 是 先 写 使 用 questionMaker 对 象 的 新 的 问题 删除 的 意图 代码 ， 即 QuestionMaker 类 应 该 有 4 个 方法 来 删除 那 4 类 问题 。” 


在 Game 类 中 将 问题 删除 的 原 有 代码 替换 为 使 用 QuestionMaker 类 的 接口 的 意图 代码 ， 如 下 所 示 (CM: Wrote question removal intention code.) : 


[ 


public class Game { 


if (currentCategory() == "Pop") 
= logger. info (PopQuestions .removeFirst () .toString()); 
+ logger. info (questionMaker. removeFirstPopQuestion ()); 
if (currentCategory() == "Science") 
= logger. info (scienceQuestions.removeFirst () .toString()); 
+ logger. info (questionMaker. removeFirstScienceQuestion ()); 
if (currentCategory() == "Sports") 
= logger. info (sportsQuestions .removeFirst () .toString ()); 
+ logger. info (questionMaker. removeFirstSportsQuestion ()); 
if (currentCategory() == "Rock") 
一 logger. info (rockQuestions .removeFirst () .上 toString () ) 
+ logger. info (questionMaker. removeFirstRockQuestion () 


) 


“ 写 好 了 问题 删除 的 意图 代码 后 ， 那 4 个 删除 问题 的 方法 显示 了 有 编译 错误 的 红色 。 应 该 来 处 理 这 些 编译 错误 ， 即 在 QuestionMaker 类 中 创建 这 4 个 删除 问题 的 方法 。” 


在 QuestionMaker 类 中 创建 4 个 问题 删除 方法 ， 代 码 如 下 (CM: Created 4 question removal methods in class QuestionMaker.) : 


public class QuestionMaker { 


public String removeFirstPopQuestion() { 
return popQuestions.removeFirst () .toString(); 


} 


public String removeFirstScienceQuestion() { 
return scienceQuestions.removeFirst () .toString(); 


} 


public String removeFirstSportsQuestion() { 
return sportsQuestions.removeFirst () .toString(); 


} 


public String removeFirstRockQuestion() { 
return rockQuestions.removeFirst () .toString(); 


十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 


} 


将 光标 定位 到 GameTest 类 名 上 ， 并 按 Ctrl+ Shift+ F10 组 合 键 运行 测试 ， 通 过 。 现 在 完成 了 将 question list 移 动 到 QuestionMaker 类 中 的 TODO。 下 面 可 以 处 理 这 些 question list 类 型 安全 的 TODO 了 。 
首先 将 其 标记 为 working-on。 


“可 以 使 用 泛 型 编程 来 给 LinkedList 添 加 一 个 类 型 参数 <String> ， 从 而 实现 类 型 安全 。” 


完成 有 关 question list 类 型 安全 的 TODO 的 代码 如 下 (CM: Finished TODO: Make question lists type-safe.) : 


public class QuestionMaker { 

= // TODO-working-on: Make question lists type-safe 

- private LinkedList popQuestions = new LinkedList (); 

一 private LinkedList scienceQuestions = new LinkedList () 7 

= private LinkedList sportsQuestions = new LinkedList (); 

private LinkedList rockQuestions = new LinkedList (); 

private LinkedList<String> popQuestions = new LinkedList<String>(); 
private LinkedList<String> scienceQuestions = new LinkedList<String>(); 
private LinkedList<String> sportsQuestions = new LinkedList<String>(); 
private LinkedList<String> rockQuestions = new LinkedList<String>(); 


public String removeFirstPopQuestion() { 
= return popQuestions.removeFirst () .toString(); 
+ return popQuestions.removeFirst (); 
} 
public String removeFirstScienceQuestion() { 
= return scienceQuestions.removeFirst () .toString (); 
+ return scienceQuestions.removeFirst (); 
} 
public String removeFirstSportsQuestion() { 
= return sportsQuestions.removeFirst () .toString(); 
+ return sportsQuestions.removeFirst (); 
} 
public String removeFirstRockQuestion() { 
一 return rockQuestions.removeFirst () .toString(); 
+ return rockQuestions.removeFirst (); 


按 Ctrl+F5 快 捷 键 重复 运行 测试 ， 运 行 测试 仍然 通过 。 


现在 咱们 已 经 写 好 了 QuestionMaker 类 。 既 然 前 面 GameTest 中 的 3 个 测试 都 没有 测试 QuestionMaker 类 的 用 户 意 图 ， 那 么 现在 是 不 是 就 可 以 对 QuestionMaker 类 进行 测试 呢 ? 


[ 


“可 以 。 咱 们 来 测试 QuestionMaker 类 的 用 户 


IR] 


: 能 够 添加 和 删除 各 类 问题 。 比 如 咱们 可 以 针对 每 类 问题 ， 先 添加 2 个 问题 ， 然 后 再 测试 能 否 成 功 地 删除 其 中 第 1 个 问题 。” 


在 GameTest 类 中 添加 4 个 有 关 QuestionMaker 类 的 高 


的 测试 TODO， 代 码 如 下 (CM: Added 4 TODOs to test the new implemented class QuestionMaker.) : 


[ 


public class GameTest { 


+ // TODO: add two pop questions and could remove the first one 
+ // TODO: add two science questions and could remove the first one 
+ // TODO: add two sports questions and could remove the first one 


十 // TODO: add two rock questions and could remove the first one 


“现在 可 以 处 理 这 4 个 用 户 意 


[ 


TODO 中 的 第 1 个 : 先 添加 两 个 流行 音乐 的 问题 ， 然 后 测试 一 下 能 否 删 除 这 两 个 问题 中 的 第 1 个 问题 。 先 编写 这 个 测试 的 Assert 部 分 。” 


添加 两 个 流行 音乐 问题 并 删除 第 1 个 问题 的 测试 Assert 部 分 ， 代 码 如 下 (CM: Working on TODO: add two pop questions and could remove the first one.Wrote an assertion.) : 


public class GameTest { 


// TODO: add two pop questions and could remove the first one 


// TODO-working-on: add two pop questions and could remove the first one 
@Test 
public void add_two_pop_questions_and_could_remove_the_first_one() { 

// Assert 


assertEquals ("Pop Question 1", questionMaker.removeFirstPopQuestion ()); 


十 十 十 十 十 十 li 


“ 接 下 来 可 以 把 这 个 测试 的 Act 和 Arrange 部 分 写 完 。” 


添加 两 个 流行 音乐 问题 并 删除 第 1 个 问题 的 测试 Act 和 Arrange 部 分 ， 代 码 如 下 (CM: Finished the 4 TODOs for testing the class QuestionMaker.) : 


// TODO-working-on: add two pop questions and could remove the first one 
@Test 
public void add_two_pop_questions_and_could_remove_the_first_one() { 

// Arrange 

QuestionMaker questionMaker = new QuestionMaker (); 


// Bot 
questionMaker.addPopQuestion ("Pop Question 1"); 
questionMaker.addPopQuestion ("Pop Question 2"); 


十 十 十 十 十 十 十 


// Assert 
assertEquals ("Pop Question 1", questionMaker.removeFirstPopQuestion()); 


“运行 测试 ， 通 过 。 有 了 这 个 测试 就 能 保证 流行 音乐 问题 的 添加 和 删除 就 没有 问题 了 。 接 下 来 可 以 类 似 地 处 理 剩 下 3 个 科学 、 体 育 和 摇滚 音乐 问题 的 用 户 意图 TODO。“ 


完成 剩 下 3 个 科学 、 体 育 和 摇滚 音乐 问题 的 用 户 意图 TODO 的 代码 如 下 : 


// TODO: add two science questions and could remove the first one 

// TODO: add two sports questions and could remove the first one 

// TODO: add two rock questions and could remove the first one 

@Test 

public void add two science questions and could remove the first one() { 
// Arrange” = "Ee a! = moa 2 
QuestionMaker questionMaker = new QuestionMaker (); 


// Bot 
questionMaker.addScienceQuestion ("Science Question 1"); 
questionMaker.addScienceQuestion ("Science Question 2"); 


// Assert 
assertEquals ("Science Question 1", questionMaker.removeFirstScienceQuestion ()); 


} 


@Test 

public void add_two_sports_questions_and_could_remove_the_first_one() { 
// Arrange 
QuestionMaker questionMaker = new QuestionMaker (); 


// Bot 
questionMaker.addSportsQuestion ("Sports Question 1"); 
questionMaker.addSportsQuestion ("Sports Question 2"); 


// Assert 
assertEquals ("Sports Question 1", questionMaker.removeFirstSportsQuestion ()); 


} 


@Test 
public void add_two_rock_questions_and_could_remove_the_first_one() { 


// Arrange 
QuestionMaker questionMaker = new QuestionMaker () ; 


// Bot 
questionMaker.addRockQuestion ("Rock Question $ 
questionMaker .addRockQuestion ("Rock Question 2"); 


// Assert 
assertEquals ("Rock Question 1", questionMaker.removeFirstRockQuestion ()); 


十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 1 


“运行 测试 ， 通 过 。 现 在 可 以 处 理 将 Game 类 的 playerName、places、purses 和 inPenaltyBox 这 4 个 成 员 变 量 移动 到 新 类 Player 的 TODO 了 。” 


前 面 有 关 4 类 问题 的 成 员 变 量 与 这 4 个 要 被 移动 到 Player 类 中 的 成 员 变 量 有 所 不 同 。 前 者 那 4 类 问题 彼此 业务 逻辑 相似 ， 所 以 可 以 一 起 处 理 。 而 后 者 所 包含 的 玩家 的 名 字 、 在 游戏 盘 上 的 位 置 、 钱 包 中 的 
6 数量 和 是 否 在 禁闭 室 的 状态 这 4 个 成 员 变量 ， 它 们 彼此 的 业务 多 辑 各 不 相同 ， 所 以 最 好 能 把 这 个 TODO 按 照 4 个 成 员 变 量 分 解 为 4 个 TODO。 


a 


在 Game 类 中 将 4 个 成 员 变 量 移动 到 Player 类 中 的 TODO 分 解 为 4 个 TODO， 代码 如 下 (CM: Split the'TODO: Move playerName, places, purses and inPenaltyBox to a new class Player'into 4 
TODOs.) : 


public class Game { 
a) // TODO: Move playerName, places, purses and inPenaltyBox to a new class Player 


+ // TODO: Move places into class Player 
private int[] places = new int[6]; 


条 
+ // TODO: Move purses into class Player 
private int[] purses = new int[6]; 

$ 


+ // TODO: Move inPenaltyBox into class Player 
private boolean[] inPenaltyBox = new boolean[6]; 


p // TODO: Move playerName into class Player 
players.add(playerName) ; 


“ 先 处 理 把 玩家 名 字 移 动 到 Player 类 的 TODO。 可 以 编写 意 


IR] 


代码 来 做 这 件 事 ， 即 希望 players 这 个 ArrayList 的 add () 方法 可 以 接受 Player 类 型 的 参数 ， 来 向 列表 中 添加 Player 对 象 。” 


Player 的 新 接口 来 添加 新 玩家 的 意图 代码 如 下 (CM: Wrote intention code to add a Player with player name to players.) : 


public class Game { 
public void add(String playerName) { 


// TODO: Move playerName into class Player 
players.add(playerName) ; 

// TODO-working-on: Move playerName into class Player 
players.add(new Player (playerName) ) ; 


++i 


“因为 现在 还 没有 创建 Player 类 ， 所 以 上 面 意图 代码 中 new Player (playerName) 语句 中 的 Player 显 示 有 编译 错误 的 红色 。 为 了 消除 这 个 错误 ， 现 在 就 可 以 创建 Player 类 和 它 的 构造 器 。” 


创建 Player 类 和 其 构造 器 的 代码 如 下 (CM: Created class Player and its constructor.) : 


+public class Player { 
E public Player (String playerName) { 
+ } 

+} 


“ 按 Ctrl+ F5 快 捷 键 运行 测试 ， 通 过 。 因 为 现在 向 玩家 列表 中 添加 玩家 名 字 的 不 再 是 字符 串 ， 而 变 成 了 Player 对 象 。 为 了 保证 类 型 安全 ， 现 在 可 以 处 理 那个 将 玩家 列表 变 为 类 型 安全 的 TODO 了 .。“ 


将 玩家 列表 变 为 类 型 安全 的 TODO 的 代码 如 下 (CM: Finished TODO: Make player list type-safe.) : 


public class Game { 


=" // TODO: Make player list type-safe 
= private ArrayList players = new ArrayList (); 
+ private ArrayList<Player> players = new ArrayList<Player>(); 


“ 按 Ctrl+F5 快 捷 键 运行 测试 ， 通 过 。 不 过 在 IDEA 的 Run 窗 口 看 到 的 日 志 ， 玩 家 的 名 字 都 是 诸如 kata.trivia.Player@11d50c0 这 样 不 正常 的 名 字 。” 


在 IDEA 的 Run 窗 口中 部 分 玩家 名 字 显 示 不 正常 的 日 志 如 下 : 


Jul 22, 2014 11:29:00 AM kata.trivia.Game currentPlayerMovesToNewPlaceAndAnswersAQuestion 
INFO: kata.trivia.Player@11d50c0's new location is 7 


‘my 


“这 是 由 于 Player 类 中 没有 覆 写 toString () 方法 。 现 在 可 以 处 理 这 件 事 。” 


在 Player 类 中 覆 写 toString () 方法 ， 以 使 得 玩家 名 字 在 日 志 中 正确 显示 ， 代 码 如 下 (CM: Added overridden method toString () to class Player to make logging printing correct player 


names.) : 


public class Player { 
private String playerName; 


++ 


public Player (String playerName) { 
this.playerName = playerName; 


} 


@Override 
public String toString() { 
return this.playerName; 


十 十 十 十 十 十 


} 


“ 按 Ctrl+F5 快 捷 键 运行 测试 ， 通 过 。 这 回 看 到 的 日 志 中 玩家 名 字 显 示 正常 了 。” 


在 IDEA 的 Run 窗 口中 部 分 玩家 名 字 显 示 正 常 的 日 志 如 下 : 


Jul 22, 2014 11:39:10 AM kata.trivia.Game currentPlayerMovesToNewPlaceAndAnswersAQuestion 
INFO: Sue's new location is 0 


我 还 注意 到 ， 在 IDEA 的 Run 窗 口 的 前 面 几 行 诸如 They are player number 3 这 样 记 录 玩 家 总 数 的 日 志 ， 有 英文 语法 错误 。 最 好 能 改 成 The total amount of players is 3。 可 以 为 这 个 问题 创建 一 个 
TODO, 


在 Game 类 中 添加 有 关 显 示 玩 家 总 数 日 志 的 语法 错误 的 TODO， 代 码 如 下 (CM: Added TODO: The logging message should be'The total amount of players is xx'.) : 


public class Game { 


+ // TODO: The logging message should be 'The total amount of players is xx' 
logger.info("They are player number " + players.size()); 


现在 玩家 名 字 在 日 志 中 已 经 显示 正常 ， 所 以 将 玩家 名 字 移 动 到 Player 类 的 TODO 就 算是 完成 了 。 现 在 可 以 来 处 理 玩家 总 数 日 志 语 法 错误 的 TODO， 把 它 标记 为 working-on。 


“处 理 玩 家 总 数 日 志 中 语法 错误 的 TODO 很 容易 ， 把 字符 串 改 一 下 就 好 了 。 " 


完成 处 理 玩家 总 数 日 志 中 语法 错误 的 TODO 的 代码 如 下 (CM: Finished TODO: The logging message should be'The total amount of players is xx'.) : 


public class Game { 


= // TODO-working-on: The logging message should be 'The total amount of 
players is xx' 

- logger.info("They are player number " + players.size()); 

+ logger.info("The total amount of players is " + players.size()); 


“测试 运行 通过 ， 而 且 日 志 中 语法 问题 也 改 好 了 。 把 玩家 名 字 移动 到 Player 类 中 ， 接 下 来 就 可 以 把 玩家 位 置 移动 到 Player 类 中 。 我 注意 到 在 Game 类 的 add () 方法 中 ， 在 把 一 个 Player 对 象 添加 到 玩家 
列表 后 ， 下 面 那 3 行 对 玩家 位 置 、 钱 包 和 在 禁闭 室 的 状态 进行 初始 化 的 语句 ， 也 要 相应 地 移动 到 Player 类 中 。 所 以 这 些 初始 化 语句 在 此 处 就 没有 用 了 ， 可 以 删除 。” 


在 Game 类 中 把 玩家 位 置 的 计算 逻辑 移动 到 Player 类 的 TODO 标 记 为 working-on， 删 除 玩家 位 置 、 钱 包 和 在 禁闭 室 的 状态 初始 化 的 语句 ， 代 码 如 下 (CM: Removed unused code from method 
Game.add () .) : 


public class Game { 


=" // TODO: Move places into class Player 
+ // TODO-working-on: Move places into class Player 


public void add(String playerName) { 
players.add(new Player (playerName) ) ; 
一 places [howManyPlayers()] = 0; 
一 purses [howManyPlayers()] = 0; 


一 inPenaltyBox [howManyPlayers()] = false; 


在 将 玩家 在 游戏 盘 上 的 位 置 移动 到 Player 类 之 前 ， 先 看 一 看 本 章 都 做 了 哪些 工作 。 


阅读 Game 这 个 大 类 的 代码 ， 计 划 把 几 个 相关 的 成 员 变 量 提取 到 新 的 Player 类 和 QuestionMaker 类 中 ， 并 用 TODO 记 录 下 来 。 


2) 使 用 “釜底抽薪 ”的 方法 ， 把 与 4 个 question list 成 员 变 量 相关 的 代码 从 Game 类 移动 到 QuestionMaker 类 。 


3) 临时 发 现在 Game 类 中 的 ArrayList 成 员 变 量 player， 和 在 QuestionMaker 类 中 的 那 4 个 LinkedList 成 员 变 量 ， 都 不 是 类 型 安全 的 ,添加 了 两 个 TODO 分 别 记 录 下 来 。 


4) 为 新 创建 的 QuestionMaker 类 编写 用 户 意图 测试 。 


5) 由 于 彼此 的 业务 逻辑 各 不 相同 ， 把 Game 类 中 将 4 个 成 员 变量 移动 到 Player 类 中 的 TODO 分 解 为 4 个 TODO。 


a 


) 通过 操练 我 们 学 到 了 以 下 技能 : 


v 


在 把 一 个 大 类 分 解 为 若干 个 小 类 前 ， 要 先 消除 重复 代码 这 样 的 代码 “ 腐 臭 ”。 


b) 对 于 总 是 聚 在 一 起 的 那些 成 员 变 量 ， 往 往 可 以 把 它们 提取 到 一 个 新 类 中 。 


新 代码 蔡 换 旧 代 码 的 “釜底抽薪 ”法 ， 另 一 种 是 照 着 旧 代 码 这 块 “ 砖 ”编写 新 代码 这 块 “ 玉 ”的 “抛砖引玉 ”法 。 前 者 适 


c) 重 构 时 替换 代码 的 方法 有 两 种 ， 一 种 是 直接 
Ei. 


d) 可 以 利用 根据 意图 修改 代码 所 产生 的 编译 错误 的 指引 ， 在 “釜底抽薪 ”的 重 构 方法 中 进行 新 旧 代码 的 替换 。 


e) 对 于 在 重 构 过 程 中 新 识别 出 来 的 代码 “ 腐 臭 ”， 可 以 随时 添加 新 的 TODO 来 记录 ， 待 时 机 成 熟 时 再 处 理 。 


f) 对 于 新 分 解 出 来 的 类 ， 要 编写 用 户 意图 测试 。 


9) 一 个 大 TODO 可 以 拆 解 为 若干 小 TODO 来 完成 。 


h) 编写 代码 主要 是 给 人 阅读 的 ， 需 要 确保 代码 在 传递 信息 方面 的 语法 和 语义 正确 ， 比 如 要 保证 日 志 信息 的 语法 正确 。 


第 14 章 “分 而 治之 一 一 抛砖引玉 


简单 的 重 构 ， 后 者 适用 了 


“把 玩家 位 置 的 计算 逻辑 移动 到 Player 类 这 件 事 ， 看 起 来 有 些 复杂 ， 可 以 使 用 “抛砖引玉 ′ 的 方法 来 进行 。 即 可 以 在 目前 的 位 置 计算 逻辑 的 后 面 编 写意 图 代码 ， 等 新 的 意图 代码 编写 完毕 ， 将 代码 行为 


切换 到 它 之 上 ， 并 运行 测试 通过 后 ， 就 可 以 删除 原来 的 位 置 计算 逻辑 。 使 用 “抛砖引玉 ”的 重 构 方法 的 好 处 是 ， 能 够 最 大 限度 地 让 测试 频繁 得 到 运行 ， 让 复杂 的 重 构 得 到 测试 最 大 限度 的 保护 。Player 类 应 


该 有 一 个 moveForwardSteps() 方法 ， 接 受 玩家 所 掷 色 子 的 点 数 作为 参数 ， 表 示 该 玩家 在 游戏 盘 上 移动 了 点 数 所 代表 的 步 数 而 到 达 了 新 的 位 置 。” 


Player 类 的 新 接口 让 玩家 在 游戏 盘 上 前 进 的 意图 代码 如 下 (CM: Wrote intention code to make the current player move forward rollingNumber steps.) : 


public class Game { 


private void currentPlayerMovesToNewPlaceAndAnswersAQuestion (int rollingNumber) { 
places[currentPlayer] = places[currentPlayer] + rollingNumber; 
+ players.get (currentPlayer) .moveForwardSteps (rollingNumber) ; 


“这 个 moveForwardsteps () 方法 目前 显示 的 是 有 编译 错误 的 红色 ， 因 此 需要 对 这 个 错误 进行 处 理 。 消 除 这 个 编译 错误 最 简单 的 方法 是 在 类 Player 中 创建 一 个 空 的 moveForwardSteps () 方法 。” 


在 类 Player 中 创建 一 个 空 的 moveForwardSsteps () 方法 的 代码 如 下 (CM: Created method Player.moveForwardSteps () .) : 


Public class Player { 


+ public void moveForwardSteps (int steps) { 
+ 
+ } 

} 


“运行 测试 ， 依 然 通 过 。 我 注意 到 ， 在 Game 类 的 currentPlayerMovesToNewPlaceAndAnswersAQuestion () 方法 中 的 加 法 和 减法 运算 ， 可 以 使 用 + = 和 -= 来 消除 重复 代码 。” 


在 Game 类 中 用 + = 和 -= 来 消除 重复 代码 的 代码 如 下 (CM: Removed duplicate code using +=and -=in method Game.currentPlayerMovesToNewPlaceAndAnswersAQuestion () .) : 


Public class Game 1{ 


private void currentPlayerMovesToNewPlaceAndAnswersAQuestion (int rollingNumber) { 
= places[currentPlayer] = places[currentPlayer] + rollingNumber; 
+ places[currentPlayer] += rollingNumber; 


= if (places[currentPlayer] > 11) places[currentPlayer] = 
places[currentPlayer] - 12; 
+ if (places[currentPlayer] > 11) places[currentPlayer] -= 12; 


“现在 Player 类 的 moveForwardsteps () 方法 还 是 空 的 ， 咱 们 可 以 编写 意图 代码 来 实现 它 。 意 图 代码 的 实现 逻辑 与 原先 的 是 一 样 的 ， 只 不 过 在 Player 类 中 要 有 一 个 place 成 
要 把 表示 位 置 的 数值 控制 在 0 到 11 之 间 。 另 外 ， 在 Game 类 的 currentPlayerMovesToNewPlaceAndAnswersAQuestion () 方法 中 ， 把 表示 位 置 的 数值 控制 在 0 到 11 之 间 的 逻辑 
面 计算 玩家 位 置 的 那 行 代码 行 挨 在 一 起 。” 


在 Player 类 中 编写 意图 代码 来 实现 moveForwardSteps () 方法 功能 代码 如 下 (CM: Wrote intention code in method Player.moveForwardSteps () .) : 


Public class Player { 


public void moveForwardSteps (int steps) { 
+ this.place += steps; 
+ if (this.place > 11) this.place -= 12; 
} 
} 
public class Game { 


员 变 量 来 保存 玩家 位 置 ， 还 
往 上 移动 一 行 ， 以 使 其 与 上 


private void currentPlayerMovesToNewPlaceAndAnswersAQuestion (int rollingNumber) { 
places[currentPlayer] += rollingNumber; 
= players.get (currentPlayer) .moveForwardSteps (rollingNumber) ; 
if (places[currentPlayer] > 11) places[{currentPlayer] -= 12; 
+ players.get (currentPlayer) .moveForwardSteps (rollingNumber) ; 


“在 上 面 Player 类 的 moveForwardsteps () 方法 的 意图 代码 中 ，3 个 place 都 显示 了 表示 编译 错误 的 红色 ， 原 因 是 未 创建 。 现 在 就 创建 它 。” 


在 Player 类 中 创建 成 员 变 量 place 并 将 其 初始 化 为 0 代码 如 下 (CM: Created field place and initialized it in class Player.) : 


public class Player { 
private String playerName; 
+ private int place = 0; 


“ 按 Ctrl+F5 快 捷 键 运行 测试 ， 通 过 。 现 在 玩家 位 置 已 经 能 在 新 的 Player 类 中 进行 计算 了 ， 接 下 来 就 可 以 将 这 个 计算 好 的 结果 从 Player 类 中 读 取 出 来 了 。 现 在 编写 意 
一 个 getPlace () 方法 来 获取 该 玩家 在 游戏 盘 上 的 位 置 。” 


代码 来 做 这 件 事 ，Player 类 应 该 有 


[ 


编写 意 


place from Player.) : 


代码 将 在 Player 类 中 计算 好 的 玩家 位 置 读 取出 来 ， 代 码 如 下 (CM: Wrote intention code in method Game.currentPlayerMovesToNewPlaceAndAnswersAQuestion () to get the 


[ 


public class Game { 
logger. info (players.get (currentPlayer) 
+ "'s new location is " 
+ places [currentPlayer]); 
logger. info (players .get (currentPlayer) 


$ 


+ + "'s new location is " 
fe + players.get (currentPlayer) .getPlace()); 
“在 上 面 的 意图 代码 中 ， 由 于 Player 类 还 没有 创建 getPlace () 方法 ， 所 以 getPlace () 显示 的 是 表示 编译 错误 的 红色 。 现 在 就 处 理 这 个 错误 。” 


在 Player 类 中 创建 和 实现 getPlace () 方法 的 代码 如 下 (CM: Created and implemented method Player.getPlace () .) : 


public class Player { 


+ public int getPlace() { 
+ return this.place; 
T } 

} 


“运行 测试 ， 通 过 。 观 察 一 下 日 志 ， 发 现 出 现 了 两 行 有 关 玩 家 位 置 的 日 志 。 上 面 一 行 是 原先 的 日 志 ， 而 下 面 一 行 是 从 新 的 Player 类 中 获取 的 玩家 位 置 的 日 志 。 两 行 日 志 完全 一 样 ， 说 明 后 者 已 经 成 功 地 
实现 了 前 者 的 功能 。” 


ay 


我 忽然 发 现 ，Game 类 中 的 currentCategory () 方法 是 根据 玩家 位 置 计算 问题 类 别 的 ， 而 决定 问题 类 别 的 逻辑 似乎 应 该 归 QuestionMaker 类 来 负责 。 可 以 添加 一 个 TODO 来 记录 这 件 导 


在 Game 类 中 添加 将 currentCategory () 方法 从 Game 类 转移 到 QuestionMaker 类 的 TODO,， 代码 如 下 (CM: Added TODO: Move method Game.currentCategory () to class 


QuestionMaker.) : 


public class Game { 


+ // TODO: Move method Game.currentCategory() to class QuestionMaker 
private String currentCategory() { 
if (places[currentPlayer] == 0) return "Pop"; 
if (places[currentPlayer] == 4) return "Pop"; 


“现在 有 了 Player 对 象 的 getPlace () 方法 ， 就 可 以 将 Game 类 中 获取 玩家 位 置 的 原 有 代码 都 替换 为 从 Player 对 象 的 getPlace () 方法 中 获取 。 先 蔡 换 currentCategory () 方法 中 的 原 有 玩家 位 置 的 代 
码 。” 


在 Game 类 的 currentCategory () 方法 中 使 用 Player 类 的 新 接口 获取 当前 玩家 位 置 ， 代 码 如 下 所 示 (CM: Got the place of the current player from Player in method 


Game.currentCategory () .) : 


public class Game { 


// TODO: Move method Game.currentCategory() to class QuestionMaker 
private String currentCategory() { 


= if (places[currentPlayer] == 0) return "Pop"; 

= if (places[currentPlayer] == 4) return "Pop"; 

- if (places [currentPlayer] 8) return "Pop"; 

= if (places [currentPlayer] 1) return "Science"; 

一 if (places [currentPlayer] 5) return "Science"; 

一 if (places[currentPlayer] 9) return "Science"; 

一 if (places[currentPlayer] 2) return "Sports"; 

一 if (Places [currentPlayer] 6) return "Sports"; 

- if (places[currentPlayer] == 10) return "Sports"; 

+ if (players.get (currentPlayer) .getPlace() == 0) return "Pop"; 

中 if (Players .get (currentPlayer) .getPlace () 4) return "Pop"; 

+ if (players.get (currentPlayer) .getPlace () 8) return "Pop"; 

+ if (players.get (currentPlayer) .getPlace () 1) return "Science"; 
+ if (players.get (currentPlayer) .getPlace () 5) return "Science"; 
+ if (players.get (currentPlayer) .getPlace () 9) return "Science"; 
+ if (players.get (currentPlayer) .getPlace () 2) return "Sports"; 
+ if (players.get (currentPlayer) .getPlace () 6) return "Sports"; 
+ if (players.get (currentPlayer) .getPlace() == 10) return "Sports"; 


return "Rock"; 


我 在 看 刚刚 新 写 的 TODO。 与 其 把 currentCategory () 方法 从 Game 类 转移 到 Question-Maker 类 ， 还 不 如 转移 到 Player 类 更 合适 。 因 为 如 果 读 一 读 currentCategory () 方法 的 代码 就 不 难 发 现 ， 该 
方法 依赖 Player 类 。 如 果 将 其 转移 到 QuestionMaker 类 ， 会 使 QuestionMaker 类 依赖 Player 类 ， 增 大 了 类 之 间 的 耦合 ， 违 背 了 高 内 聚 、 低 看 合 的 设计 原则 。 而 将 currentCategory () 方法 转移 到 Player 类 
中 就 能 消除 这 个 耦合 。 另 外 ， 该 方法 的 返回 值 虽然 是 表示 问题 类 别 的 字符 串 ， 但 在 字符 串 的 层面 上 不 会 产生 新 的 类 之 间 的 耦合 ， 所 以 转移 到 Player 类 更 合适 。 


将 currentCategory () 方法 从 Game 类 转移 到 QuestionMaker 类 改 为 转移 到 Player 类 ， 代码 如 下 (CM: Updated'TODO: Move method Game.currentCategory () to class QuestionMaker'to 


be'TODO: Move method Game.currentCategory () to class Player.since this method depends on Player.) : 


public class Game { 


= // TODO: Move method Game.currentCategory() to class QuestionMaker 
+ // TODO: Move method Game.currentCategory() to class Player 


private String currentCategory() { 
if (players.get (currentPlayer) .getPlace () 
if (Players .get (currentPlayer) .getPlace () 


0) 
== 4) 


return "Pop"; 
return "Pop"; 


“在 Player 类 有 了 支持 玩家 位 置 的 公共 方法 后 ，Game 类 中 获取 玩家 位 置 的 原 有 代码 就 没 


能 继续 删除 。” 


了 ， 可 以 将 其 删除 。 不 妨 将 Game 类 的 places 成 


将 Game 类 的 places 成 员 变量 删除 的 代码 如 下 (CM: Removed field places from class Game.) : 


an. 
ASS: 


量 删除 ， 然 后 让 编译 器 显示 编译 


ths 


AIR, 


以 告诉 咱们 何 处 还 


Ht 


public class Game { 


// TODO-working-on: Move places into class Player 
private int[] places = new int[6]; 


“删除 了 places 成 员 变量 ， 
咱们 就 已 经 完成 了 将 玩家 位 置 从 Game 类 移动 到 Player 类 的 TODO.“ 


完成 将 玩家 位 置 从 Game 类 移动 到 Player 类 的 TODO 的 代码 如 下 (CM: Removed all places-related code from class Game.Finished TODO: Move places into class Player.) : 


public class Game { 


// TODO-working-on: Move places into class Player 


private void currentPlayerMovesToNewPlaceAndAnswersAQuestion (int rollingNumber) { 


places[currentPlayer] += rollingNumber; 


if (places[currentPlayer] > 11) places[currentPlayer] -= 


12; 


players.get (currentPlayer) .moveForwardSteps (rollingNumber) ; 


logger. info (players.get (currentPlayer) 

+ "'s new location is " 

+ places [currentPlayer]); 
logger. info (players.get (currentPlayer) 

+ "'s new location is " 

+ players.get (currentPlayer) .getPlace()); 
logger.info("The category is " + currentCategory()); 
askQuestion (); 


在 Game 类 中 ， 就 能 很 容易 地 看 到 在 currentPlayerMovesToNewPlaceAndAnswersAQuestion () 方法 中 有 4 处 places 显 示 编 译 错误 的 红色 。 现 在 来 删除 这 些 原 有 代码 。 这 


“现在 可 以 处 理 将 currentCategory () 方法 从 Game 类 移动 到 Player 类 的 TODO 了 ， 把 它 标 记 为 working-on。” 


“ 接 下 来 就 可 以 把 currentCategory () 整个 方法 从 Game 类 移动 到 Player 类 中 。 这 个 重 构 比较 简 


和 R， 可 以 使 用 “釜底抽薪 ”的 重 构 方法 。 


将 currentCategory () 整个 方法 从 Game 类 移动 到 Player 类 中 的 代码 如 下 (CM: Moved method currentCategory () from class Game to Player.) : 


public class Game { 


private String currentCategory () 


// TODO-working-on: Move method Game.currentCategory() to class Player 


{ 

= if (players.get (currentPlayer) .getPlace () return "Pop"; 

S if (players.get (currentPlayer) .getPlace () return "Pop"; 

= if (players.get (currentPlayer) .getPlace () return "Pop"; 

一 if (Players.get (currentPlayer) .getPlace () return "Science"; 
一 if (Players.get (currentPlayer) .getPlace () return "Science"; 
一 if (players.get (currentPlayer) .getPlace () return "Science"; 
= if (players.get (currentPlayer) .getPlace () return "Sports"; 
= if (players.get (currentPlayer) .getPlace () return "Sports"; 
= if (players.get (currentPlayer) .getPlace () return "Sports"; 


return "Rock"; 


于 } 


public class Player { 


} 


+ // TODO-working-on: Move method Game.currentCategory() to class Player 
+ private String currentCategory() { 

+ if (this.place == 0) return 

+ if (this.place 4) return 

+ if (this.place 8) return " 

+ if (this.place 1) return 

+ if (this.place 5) return 

+ if (this.place 9) return ; 
+ if (this.place 2) return "Sports"; 
+ if (this.place 6) return "Sports"; 
+ if (this.place == 10) return "Sports"; 
+ return "Rock"; 

+ } 


“这 么 一 移动 ， 原 来 在 Game 类 中 对 currentCategory () 方法 的 调 


都 变 成 有 编译 错误 的 红色 。 下 面 来 处 理 它们 ， 即 在 Game 类 中 编写 意 


是 说 ，Player 类 应 该 有 一 个 getCurrentCategory () 方法 。” 


在 Game 类 中 编写 意 


IR] 


代码 从 Player 类 的 新 接口 


Game.) : 


网 


代码 ， 以 从 Player 类 中 获取 当前 玩家 的 当前 问题 类 别 。 也 就 


中 获取 当前 玩家 的 当前 问题 类 别 ， 代 码 如 下 (CM: Wrote intention code to get current category of the current player from Player in class 


public class Game { 


logger.info("The category is " + currentCategory()); 
getCurrentCategory ()); 
private void askQuestion() { 


if (currentCategory () Pop") 
if (players.get (currentPlayer) .getCurrentCategory () 


logger. info (questionMaker . removeFirstPopQuestion () 


(currentCategory () Science") 
(players.get (currentPlayer) .getCurrentCategory () 


logger.info("The category is " + players.get (currentPlayer) . 


"pop") 
); 


"Science") 


logger . info (questionMaker. removeFirstScienceQuestion ()); 


(currentCategory () Sports") 
(players.get (currentPlayer) .getCurrentCategory () 


Sports") 


logger. info (questionMaker. removeFirstSportsQuestion () ); 


(currentCategory () Rock") 
(players.get (currentPlayer) .getCurrentCategory () 


== "Rock") 


logger. info (questionMaker. removeFirstRockQuestion () ) 7 


“在 上 面 这 些 意 


代码 中 ， 有 5 处 getCurrentCategory () 方法 显示 的 是 有 编译 错误 的 红色 ， 
currentCategory () 方法 改名 为 getCurrentCategory () 并 定义 为 公有 的 就 可 以 了 。 


因 


为 这 个 方法 还 未 创建 。 现 在 就 处 理 这 5 处 编译 错误 。 只 要 把 移动 到 Player 类 中 的 私有 的 
运行 测试 ， 通 过 。 这 样 ， 将 currentCategory () 方法 从 Game 类 移动 到 Player 类 的 TODO 也 完成 了 。” 


完成 有 关 移 动 Game 类 的 currentCategory () 方法 的 TODO 的 代码 如 下 (CM: Updated the method Player.currentCategory () to be Player.getCurrentCategory () .Finished TODO: Move 


method Game.currentCategory () to class Player.) : 


Public class Player { 


= // TODO-working-on: Move method Game.currentCategory() to class Player 
= private String currentCategory() { 
+ public String getCurrentCategory() { 
if (this.place == 0) return "Pop"; 
if (this.place == 4 
if (this.place = 8 


n 
0 
ct 
E 
5 
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return "Pop"; 


“完成 了 将 currentCategory () 方法 从 Game 类 移动 到 Player 类 的 TODO， 接 下 来 该 处 理 将 玩家 的 钱包 移动 到 Player 类 中 的 TODO 了 。 把 它 标记 为 working-on。” 


“这 个 TODO 的 重 构 也 相对 比较 复杂 ， 使 用 “抛砖引玉 ”的 方法 。 先 在 Game 类 中 从 上 到 下 用 关键 词 purses 查 找 与 玩家 钱包 相关 的 原 有 代码 。 首 先 在 方法 currentPlayerGetsAGold 
CoinAndSelectNextPlayer () 中 找到 了 玩家 赢 取 金币 的 原 有 代码 ， 然 后 在 这 行 代码 后 面 编写 使 用 Player 类 实现 同样 赢 取 金 币 功 能 的 意图 代码 ， 即 Player 类 应 该 有 一 个 winAGoldCoin () 方法 ， 表 示 该 玩家 
赢得 了 一 块 金币 。” 


在 Game 类 的 currentPlayerGetsAGoldCoinAndselectNextPlayer () 方法 中 编写 意图 代码 ， 以 实现 使 用 Player 类 的 新 接口 让 当前 用 户 赢 取 金 币 ， 代 码 如 下 (CM: Wrote intention code to make 


the current player win a gold coin in method Game.currentPlayerGetsAGoldCoinAndSelectNextPlayer () .) : 


public class Game { 
private boolean currentPlayerGetsAGoldCoinAndSelectNextPlayer() { 


logger.info("Answer was correct!!!!"); 
purses [currentPlayer]++; 
+ players.get (currentPlayer) .winAGoldCoin (); 


“由 于 Player 类 的 winAGoldCoin () 方法 尚未 定义 ， 所 以 上 面 的 意图 代码 中 winAGoldCoin () 显示 的 是 编译 错误 的 红色 ， 现 在 来 处 理 这 个 错误 ， 即 在 Player 类 中 创建 一 个 空 的 winAGoldCoin () A 


在 Player 类 中 创建 空 的 winAGoldCoin () 方法 的 代码 如 下 (CM: Created method Player.winAGoldCoin () .) : 


Public class Player { 
+ public void winAGoldCoin() { 
+ 
+ } 
} 


“运行 测试 ， 通 过 。 编 写 完 使 用 Player 类 的 赢 取 金币 功能 的 意图 代码 后 ， 接 下 来 在 Game 类 中 再 用 关键 词 purses 继 续 查找 与 玩家 钱包 相关 的 代码 ， 又 在 
currentPlayerGetsAGoldCoinAndSelectNextPlayer () 方法 中 查 到 了 获取 金币 数量 的 原 有 代码 ， 然 后 在 其 后 添加 新 的 使 用 Player 类 获取 金币 数量 的 意图 代码 ， 即 Player 类 应 该 有 一 个 名 为 
countGoldCoins () 的 公共 方法 来 获取 金币 数量 。” 


[ 


在 Game 类 的 currentPlayerGetsAGoldCoinAndselectNextPlayer () 方法 中 编写 意图 代码 ， 以 实现 使 用 Player 类 的 新 接口 获取 当前 玩家 的 金币 数量 ， 代 码 如 下 (CM: Wrote intention code to 


count the gold coins of the current player in method Game.currentPlayerGetsAGoldCoinAndSelectNextPlayer () .) : 


public class Game { 
logger. info (players .get (currentPlayer) 
+" now has " 
+ purses [currentPlayer] 
+ " Gold Coins."); 
logger. info (players .get (currentPlayer) 
+" now has " 
+ players.get (currentPlayer) .countGoldCoins () 
+ " Gold Coins."); 


十 十 十 十 


“在 上 面 的 意图 代码 中 ，countGoldCoins () 方法 由 于 尚未 创建 ， 所 以 是 编译 错误 的 红色 。 现 在 就 处 理 这 个 错误 ， 即 创建 并 实现 Player 类 的 countGoldCoins () 方法 ， 另 外 把 winAGoldCoin () A 
法 也 实现 了 。” 


创建 并 实现 Player 类 的 countGoldCoins () 方法 ， 以 及 实现 winAGoldCoin () 方法 ,代码 如 下 (CM: Created and implemented method Player.countGoldCoins () .Implemented method 
Player.winAGoldCoin () .) : 


public class Player { 
private String playerName; 
private int place = 0; 

+ private int sumOfGoldCoins = 0; 


public void winAGoldCoin() { 
this.sumOfGoldCoins++; 

} 

public int countGoldCoins() { 
return this.sumOfGoldCoins; 


十 十 十 十 


} 


“运行 测试 ， 通 过 。” 


忽然 发 现 ，Game 类 的 isGamestilllnProgress () 方法 中 有 一 个 魔法 数 6， 其 实 就 是 获胜 的 玩家 赢 取 的 最 大 金币 数 ， 应 该 用 一 个 名 称 富 有 表达 力 的 公共 常量 来 表示 ， 以 便于 阅读 和 统一 修改 。 目 前 正在 把 
玩家 钱包 相关 的 逻辑 移动 到 Player 类 中 ， 无 暇 修改 ， 所 以 添加 一 个 TODO 记 下 来 以 后 再 改 。 


在 Game 类 中 添加 有 关 魔 法 数 6 的 TODO， 代 码 如 下 (CM: Added TODO: The magic number 6.) : 


public class Game { 


+ // TODO: The magic number 6 
private boolean isGameStillInProgress() { 
return ! (purses[currentPlayer] == 6); 


} 


“接着 在 Game 类 中 用 关键 词 purses 查 找 与 玩家 钱包 相关 的 原 有 代码 。 在 Game 类 的 最 后 一 个 方法 isGamestilllnProgress () 中 查 到 了 获取 当前 玩家 金币 数量 的 原 有 代码 ， 这 个 功能 可 以 用 前 面 创建 的 
Player 类 的 countGoldCoins () 方法 来 实现 。” 


在 Game 类 的 方法 isGamestilllnProgress () 中 使 用 Player 类 的 新 接口 获取 当前 玩家 金币 数量 ， 代 码 如 下 (CM: Got number of gold coins of current player from Player in method 
Game.isGameStilllnProgress () .) : 


public class Game { 


// TODO: The magic number 6 


private boolean isGameStillInProgress() { 
一 return ! (purses [currentPlayer] == 6); 
+ return ! (players.get (currentPlayer) .countGoldCoins() == 6); 


“现在 已 经 把 Game 类 中 与 玩家 钱包 相关 的 代码 都 用 Player 的 接口 蔡 换 完了 ， 该 到 了 删除 原 有 玩家 钱包 相关 代码 的 时 候 了 。 先 从 删除 Game 类 的 purses 成 员 变量 开始 。“ 


删除 Game 类 的 purses 成 员 变 量 的 代码 如 下 (CM: Removed field purses from class Game.) : 


public class Game { 


// TODO-working-on: Move purses into class Player 
一 private int[] purses = new int[6]; 


“删除 了 Game 类 的 成 员 变 量 purses 后 ， 在 Game 类 的 currentPlayerGetsAGoldCoinAndSelectNextPlayer () 方法 里 出 现 了 2 处 红色 的 表示 有 编译 错误 的 purses。 现 在 就 删除 它们 。 运 行 测试 ， 通 
过 。 这 样 将 玩家 钱包 相关 逻辑 移动 到 Player 类 中 的 TODO 就 完成 了 。” 


完成 有 关 将 玩家 钱包 移动 到 Player 类 的 TODO 的 代码 如 下 所 示 (CM: Removed all purses-related code from class Game.Finished TODO: Move purses into class Player.) : 


public class Game { 
a // TODO-working-on: Move purses into class Player 


private boolean currentPlayerGetsAGoldCoinAndSelectNextPlayer() { 
logger.info("Answer was correct!!!!"); 
ag purses [currentPlayer] ++; 
players .get (currentPlayer) .winAGoldCoin () ; 
logger. info (players .get (currentPlayer) 
+" now has " 
+ purses [currentPlayer] 
+ " Gold Coins."); 
logger. info (players.get (currentPlayer) 
+" now has " 
+ players.get (currentPlayer) .countGoldCoins () 
+ " Gold Coins."); 


“现在 终于 要 处 理 从 Game 类 向 Player 类 移动 玩家 在 禁闭 室 的 状态 inPenaltyBox 这 最 后 一 个 成 员 变 量 了 。 先 把 有 关 这 个 移动 的 TODO 标 记 为 working-on。” 


“对 于 这 个 比较 复杂 的 重 构 也 使 用 ‘抛砖引玉 ”的 方法 。 在 Game 类 中 用 关键 词 inPenaltyBox 进 行 查找 ， 在 Game 类 的 roll () 方法 中 找到 了 玩家 是 否 在 禁闭 室 、 走 出 禁闭 室 和 呆 在 禁闭 室 这 3 处 应 用 。 
可 以 让 Player 类 具有 isinPenaltyBox () 、getOutOfPenaltyBox () 和 staylnPenaltyBox () 这 3 个 接口 ， 来 分 别 对 应 这 3 处 应 用 。” 


在 Game 类 的 roll () 方法 中 编写 意图 代码 来 处 理 有 关 玩 家 在 禁闭 室 状态 的 代码 如 下 所 示 (CM: Wrote intention code to use the field isinPenaltyBox and isGettingOutOfPenaltyBox in class 


Player in method Game.roll () .) : 


public class Game { 
logger. info (players.get (currentPlayer) + " is the current player"); 
logger.info("They have rolled a " + rollingNumber) ; 
= if (inPenaltyBox[currentPlayer]) { 
+ if (inPenaltyBox[currentPlayer] || players.get (currentPlayer) . 
isInPenaltyBox()) { 
if (rollingNumber % 2 != 0) { 
isGettingOutOfPenaltyBox = true; 
+ players.get (currentPlayer) .getOutOfPenaltyBox () ; 
logger. info (players.get (currentPlayer) + " is getting out of 
the penalty box"); 
currentPlayerMovesToNewPlaceAndAnswersAQuestion (rollingNumber) ; 
} else { 
logger. info (players.get (currentPlayer) + " is not getting out 
of the penalty box"); 
isGettingOutOfPenaltyBox = false; 
+ players .get (currentPlayer) .stayInPenaltyBox () ; 
} 


} else { 


“上 面 代码 中 的 原 有 代码 出 现在 if 条 件 中 ， 则 其 可 以 与 其 功能 等 价 的 意图 代码 相 或 ”而 出 现在 同一 个 if 条 件 中 ， 这 样 就 不 会 在 代码 运行 时 影响 原 有 代码 的 功能 。” 


区 


“在 Game 类 的 roll () 方法 中 期 望 Player 类 所 具有 的 islnPenaltyBox () 、getOutOfPenalty-Box () 和 staylnPenaltyBox () 这 3 个 公共 方法 都 尚未 创建 ， 所 以 显示 了 编译 错误 的 红色 。 现 在 一 个 一 
个 地 创建 它们 。 先 创建 和 实现 Player 类 的 islnPenaltyBox () 方法 。” 


创建 和 实现 Player 类 的 islnPenaltyBox () 方法 的 代码 如 下 所 示 (CM: Created and imple-mented method Player.isinPenaltyBox () .) : 


Public class Player { 
+ private boolean isInPenaltyBox = false; 
+ public boolean isInPenaltyBox() { 


+ return this.isInPenaltyBox; 
+ } 


“现在 Game 类 的 roll () 方法 中 的 islnPenaltyBox () 不 再 是 红色 的 了 。 接 下 来 创建 和 实现 Player 类 的 getOutOfPenaltyBox () 和 staylnPenaltyBox () Aik. ” 


创建 和 实现 Player 类 的 getOutOfPenaltyBox () 方法 的 代码 如 下 所 示 (CM: Created and implemented method Player.getOutOfPenaltyBox () .) : 


public class Player { 
+ private boolean isGettingOutOfPenaltyBox = true; 
+ public void getOutOfPenaltyBox() { 


+ this.isGettingOutOfPenaltyBox = true; 
+ } 


创建 和 实现 Player 类 的 staylnPenaltyBox () 方法 的 代码 如 下 所 示 (CM: Created and imple-mented method Player.staylnPenaltyBox () .) : 


Public class Player { 


+ public void stayInPenaltyBox() { 
+ this. isGettingOutOfPenaltyBox = false; 


运行 测试 ， 通 过 。 处 理 完了 Game 类 的 roll () 方法 中 出 现 的 inPenaltyBox， 再 接着 在 Game 类 中 用 关键 词 inPenaltyBox 进 行 查找 。 下 一 个 出 现 inPenaltyBox 的 方法 是 was- 


CorrectlyAnswered () 。 还 是 在 这 个 方法 里 面 “抛砖引玉 ”， 在 原 有 代码 旁边 写 使 用 Player 类 的 新 的 意 
有 的 isGettingOutOfPenaltyBox 成 员 变 量 实现 功能 等 价 。” 


网 


代码 接口 。 这 里 ，Player 类 还 应 该 有 一 个 名 为 jsGettingOutOfPenaltyBox () 的 公共 方法 ， 与 原 


在 Game 类 的 wasCorrectlyAnswered () 方法 中 编写 意图 代码 来 使 用 Player 类 的 新 接口 处 理 有 关 玩家 在 禁闭 室 状态 的 代码 如 下 所 示 (CM: Wrote intention code to know if the current player is 


getting out of penalty box from Player in method Game.wasCorrectlyAnswered () .) : 


public class Game { 


public boolean wasCorrectlyAnswered() { 
= if (inPenaltyBox [currentPlayer]) { 
一 if (isGettingOutOfPenaltyBox) { 


+ if (inPenaltyBox[currentPlayer] || players.get (currentPlayer) . 
isInPenaltyBox()) { 
+ if (isGettingOutOfPenaltyBox || players.get (currentPlayer) . 


isGettingOutOfPenaltyBox()) { 

return currentPlayerGetsAGoldCoinAndSelectNextPlayer () ; 
} else { 

nextPlayer () 7 


“由 于 上 面 的 意图 代码 中 的 isGettingOutOfPenaltyBox () 方法 尚未 创建 ， 所 以 是 红色 的 。 现 在 就 创建 和 实现 这 个 方法 。” 


创建 并 实现 Player 类 的 isGettingOutOfPenaltyBox () 方法 的 代码 如 下 所 示 (CM: Created and implemented method Player.isGettingOutOfPenaltyBox () .) : 


public class Player { 


public boolean isGettingOutOfPenaltyBox() { 
return this.isGettingOutOfPenaltyBox; 


++; 


+ } 


“接着 在 Game 类 中 用 关键 词 inPenaltyBox 继 续 查 找 。 在 最 后 一 个 方法 wrongAnswer () 中 又 找到 了 这 个 关键 词 。 因 为 此 处 是 当 玩 家 
现 这 个 意图 的 代码 ， 不 妨 起 名 叫 sentToPenaltyBox () 方法 。” 


回 


答 问题 错误 后 就 被 送 入 禁闭 室 ， 所 以 在 它 下 面 添 加 Player 类 的 表 


网 


在 Game 类 的 wrongAnswer () 方法 中 编写 意图 代码 来 用 Player 类 的 新 接口 将 当前 玩家 送 入 禁闭 室 的 代码 如 下 所 示 (CM: Wrote intention code to send the current player to penalty box in 


class Player in method Game.wrongAnswer () .) : 


public class Game { 
cs public boolean wrongAnswer() { 


inPenaltyBox[currentPlayer] = true; 
+ players .get (currentPlayer) .sentToPenaltyBox () ; 


a 
区 


代码 sentToPenaltyBox () 还 未 创建 ， 所 以 是 红色 。 现 在 就 创建 并 实现 它 。” 


创建 并 实现 Player 类 的 sentToPenaltyBox () 方法 的 代码 如 下 所 示 (CM: Created and imple-mented method Player.sentToPenaltyBox () .) : 


Public class Player { 


十 public void sentToPenaltyBox() { 
+ this.isInPenaltyBox = true; 
+ } 

} 


“运行 测试 ， 通 过 。 现 在 玩家 在 禁闭 室 的 状态 的 原 有 代码 旁边 都 编写 了 使 用 Player 类 的 接口 的 新 代码 ， 所 以 到 了 删除 原 有 代码 的 时 候 了 。 可 以 从 Game 类 中 删除 inPenaltyBox 和 
isGettingOutOfPenaltyBox 这 两 个 成 员 变量 。 " 


从 Game 类 中 删除 inPenaltyBox 和 isGettingOutOfPenaltyBox 这 两 个 成 员 变 量 的 代码 如 下 所 示 (CM: Removed field inPenaltyBox and isGettingOutOfPenaltyBox from class Game.) : 


public class Game { 


// TODO-working-on: Move inPenaltyBox into class Player 
一 private boolean[] inPenaltyBox = new boolean[6]; 
private int currentPlayer = 0; 
= private boolean isGettingOutOfPenaltyBox; 


“删除 了 这 两 个 成 员 变 量 后 ， 在 Game 类 中 就 出 现 了 不 少 红色 的 编译 错误 。 把 这 些 有 红色 错误 的 代码 删除 ， 再 运行 测试 ， 通 过 。 这 样 ， 将 玩家 在 禁闭 室 状态 的 代码 移动 到 Player 类 的 TODO 也 完成 了 。” 


在 Game 类 中 删除 所 有 与 inPenaltyBox 和 isGettingOutOfPenaltyBox 这 两 个 成 员 变量 相关 的 红色 编译 错误 的 代码 如 下 所 示 (CM: Removed all inPenaltyBox-and isGetting-OutOfPenaltyBox- 


related code from class Game.Finished TODO: Move inPenaltyBox into class Player.) : 


public class Game { 


> // TODO-working-on: Move inPenaltyBox into class Player 


a if (inPenaltyBox[currentPlayer] || players.get (currentPlayer) . 
isInPenaltyBox()) { 
+ if (Players .get (currentPlayer) .isInPenaltyBox()) { 


if (rollingNumber % 2 != 0) { 
= isGettingOutOfPenaltyBox = true; 
players.get (currentPlayer) .getOutOfPenaltyBox () ; 
logger. info (players.get (currentPlayer) + " is getting out of 
the penalty box"); 
currentPlayerMovesToNewPlaceAndAnswersAQuestion (rollingNumber) ; 
} else { 
logger. info (players.get (currentPlayer) + " is not getting out 
of the penalty box"); 
= isGettingOutOfPenaltyBox = false; 
players .get (currentPlayer) .stayInPenaltyBox () ; 
} 


public boolean wasCorrectlyAnswered() { 
一 if (inPenaltyBox[currentPlayer] || Players.get (currentPlayer) . 
isInPenaltyBox()) { 
= if (isGettingOutOfPenaltyBox || players.get (currentPlayer) . 
isGettingOutOfPenaltyBox()) { 


+ if (players.get (currentPlayer) .isInPenaltyBox()) { 
+ if (players.get (currentPlayer) .isGettingOutOfPenaltyBox()) { 
return currentPlayerGetsAGoldCoinAndSelectNextPlayer () ; 
} else { 
nextPlayer () 7 


public boolean wrongAnswer() { 
logger.info("Question was incorrectly answered") ; 
logger. info (players.get (currentPlayer) + " was sent to the penalty box"); 
一 inPenaltyBox[currentPlayer] = true; 


players.get (currentPlayer) .sentToPenaltyBox () ; 
nextPlayer (); 


“至 此 ， 将 Game 类 中 与 玩家 的 名 字 、 在 游戏 盘 上 的 位 置 、 钱 包 中 的 金币 数量 和 是 否 在 禁闭 室 的 状态 相关 的 代码 移动 到 Player 类 的 工作 基本 做 完了 。 不 过 还 是 发 现 了 一 些 其 他 问题 没有 解决 。” 


在 解决 这 些 问 题 之 前 ， 让 我 们 看 看 本 章 又 做 了 什么 工作 。 


1) 使 用 “抛砖引玉 ”的 方法 把 相对 复杂 的 玩家 位 置 的 计算 逻辑 移动 到 Player 类 中 。 


2) 临时 发 现 Game 类 中 的 currentCategory () 方法 ， 是 根据 玩家 位 置 计算 问题 类 别 的 ， 应 该 归 QuestionMaker 类 来 负责 ， 添 加 了 一 个 TODO 来 记录 此 问题 。 


3) 与 其 把 currentCategory () 方法 从 Game 类 转移 到 QuestionMaker 类 ， 还 不 如 转移 到 Player 类 更 合适 ， 因 为 这 样 能 更 好 地 实现 高 内 聚 、 低 耦合 的 设计 原则 。 


4) 使 用 “釜底抽薪 ”的 重 构 方法 把 currentCategory() 方法 整个 从 Game 类 移动 到 Player 类 中 。 


5) 使 用 “抛砖引玉 ”的 方法 将 玩家 的 钱包 移动 到 Player 类 中 。 


6) 使 用 “抛砖引玉 ”的 方法 从 Game 类 向 Player 类 移动 玩家 在 禁闭 室 的 状态 。 


7) 通过 操练 我 们 学 到 了 以 下 技能 : 


a) 使 用 += 和 -= 可 以 消除 重复 代码 。 


b) 应 该 本 着 高 内 聚 和 低 耦 合 的 原则 在 类 之 间 移 动 成 员 方法 。 


c) 使 用 “抛砖引玉 ”的 重 构 方法 能 够 最 大 限度 地 让 测试 频繁 得 到 运行 。 


d) 将 魔法 数 提取 成 常量 重 命名 ， 以 增强 其 可 读 性 、 可 维护 性 ， 并 能 消除 重复 代码 。 


e) 使 用 “抛砖引玉 ”的 重 构 方法 时 ， 若 原 有 代码 出 现在 if 条 件 中 ， 则 其 可 以 与 其 功能 等 价 的 意图 代码 做 逻辑 “或 ”运算 而 出 现在 同一 个 if 条 件 中 ， 这 样 就 不 会 在 代码 运行 时 影响 原 有 代码 的 功能 。 


第 15 章 ”打扫 战场 


现在 咱们 这 个 答题 闯关 Trivia 题 目的 服务 端的 类 ， 由 原先 的 1 个 Game 类 变 为 现在 的 3 个 类 : Game、QuestionMaker 和 Player。 其 中 ，Game 类 负责 添加 玩家 、 掷 色 子 、 处 理 玩家 回答 问题 正确 和 错误 的 
情况 这 些 维护 游戏 运行 的 事情 ; QuestionMaker 类 负责 添加 和 删除 在 游戏 中 要 提出 的 问题 ;Player 类 负责 维护 玩家 的 名 字 、 在 游戏 盘 上 的 位 置 、 钱 包 中 的 金币 数量 和 是 否 在 禁闭 室 的 状态 这 些 与 玩家 自身 相 
关 的 事情 。 现 在 看 起 来 ， 这 个 题目 在 类 的 职责 划分 上 基本 没有 什么 大 问题 了 ， 大 部 分 代码 “ 腐 臭 ”也 已 经 在 前 面 处 理 了 。 在 结束 这 个 编程 题目 之 前 ， 还 需要 打扫 战场 ， 清 理 一 下 遗留 的 代码 “ 腐 臭 ”。 


“我 刚才 想 说 的 没有 解决 的 一 个 问题 ， 就 是 在 Player 类 中 ， 我 感觉 isInPenaltyBox 和 isGettingOutOfPenaltyBox 这 两 个 成 员 变 量 有 些 匈 余 ， 应 该 可 以 去 掉 一 个 。 它 们 其 实 就 是 表示 这 个 玩家 是 否 在 禁闭 
室 这 个 状态 而 已 ， 为 什么 要 用 两 个 成 员 变 量 来 表示 这 一 件 事 ， 让 人 难以 理解 呢 ?“ 


对 ， 是 有 些 让 人 难以 理解 。 可 以 把 isGettingOutOfPenaltyBox 这 个 成 员 变 量 删除 ， 添 加 一 个 TODO 来 记录 这 件 事 。 


在 Player 类 中 添加 把 成 员 变 量 isGettingOutOfPenaltyBox 删 除 的 TODO 的 代码 如 下 所 示 (CM: Added TODO: Eliminate field Play.isGettingOutOfPenaltyBox.) : 


public class Player { 
private int place = 0; 
private int sumOfGoldCoins = 0; 
private boolean isInPenaltyBox = false; 
+ // TODO: Eliminate field Play.isGettingOutOfPenaltyBox 
private boolean isGettingOutOfPenaltyBox = true; 


咱们 可 以 再 回顾 一 下 这 几 个 类 ， 看 看 还 有 什么 遗漏 的 代码 “ 腐 臭 ”。 


“在 Game 类 的 构造 器 中 有 两 个 魔法 数 ， 一 个 是 try 语 句 中 的 10000000， 还 有 一 个 是 for 循 环 中 的 50。” 


对 。 另 外 在 roll () 方法 中 ， 第 2 个 if 语 句 的 条 件 判断 (rollingNumber %2! =0) 不 大 好 读 ， 不 如 提取 出 一 个 具有 良好 命名 的 解释 性 的 变量 [1 来 说 明 这 个 条 件 就 是 “所 毛色 子 点 数 是 奇数 ”这 件 事 。 


在 Game 类 中 添加 2 个 魔法 数 和 1 个 有 关 解 释 性 变量 的 TODO 的 代码 如 下 所 示 (CM: Added 3 TODOs for class Game: 1) Magic number 10000000; 2) Magic number 50; 3) Introduce 


explaining variable isRollingNumberOdd.) : 


public class Game { 


public Game() { 
try { 
+ // TODO: Magic number 10000000 
fileHandler = new FileHandler ("%h/Game-logging.log", 10000000, 1, true); 


+ // TODO: Magic number 50 
for (int i = 0; i < 50; i++) { 
questionMaker.addPopQuestion ("Pop Question " + i); 
questionMaker.addScienceQuestion(("Science Question " + i)); 


+ // TODO: Introduce explaining variable isRollingNumberOdd 
if (rollingNumber % 2 != 0) { 
players .get (currentPlayer) .getOutOfPenaltyBox () ; 


“在 Player 类 中 又 有 两 个 魔法 数 ， 一 个 是 moveForwardSteps () 方法 中 的 12， 还 有 一 个 是 getCurrentCategory () 方法 中 的 0、4、8、1、5、9、2、6 和 10。” 


在 Player 类 中 添加 2 个 有 关 魔 法 数 的 TODO 的 代码 如 下 所 示 (CM: Added 2 TODOs for class Player: 1) Magic number 12; 2) Magic number 0, 4, 8, 1, 5, 9, 2, 6, 10.) : 


Public class Player { 


public void moveForwardSteps (int steps) { 
this.place += steps; 
+ // TODO: Magic number 12 
if (this.place > 11) this.place -= 12; 
} 


public String getCurrentCategory() { 

+ // TODO: Magic number 0, 4, 8, 1, 5, 9, 2, 6, 10 
if (this.place == 0) return "Pop"; 

if (this.place 4) return "Pop"; 

if (this.place == 8) return "Pop"; 


按 Alt+ 6 快捷 键 查看 现 有 的 TODO， 发 现 共有 9 个 TODO。 


在 IDEA 中 的 TODO 窗 口中 显示 的 9 个 TODO 如 图 15-1 所 示 。 


v Found 9 TODO items in 3 files 
v © kata.trivia (9 items in 3 files) 


(m) E] (22, 16) // TODO: Magic number 10000000 
g (30, 12) // TODO: Magic number 50 
回 | (56, 16) // TODO: Introduce explaining variable isRollingNumberOdd 
(133, 12) // TODO-later: The return value of method Game. wrongAnswer() is unnecessary and should be eliminated 
国 (137, 8) // TODO: The magic number 6 
= v GameRunner,java 
(22, 20) // TODO-later: The name of the variable notAWinner should be isGamesStillinProgress 
了 
HE 


y © Player.java 
E (11, 8) // TODO: Eliminate field Play.isGettingOutOfPenaltyBox 
E (25, 12) // TODO: Magic number 12 
E] (34, 12) // TODO: Magic number 0, 4, 8, 1, 5, 9, 2, 6, 10 


w 


15-1 在 IDEA 中 的 TODO 窗 口中 显示 的 9 个 TODO 


可 以 从 这 9 个 TODO 中 挑选 简单 的 先 做 。 那 个 引入 解释 性 的 变量 的 TODO 看 起 来 简单 ， 可 以 先 做 这 个 。 把 它 标记 为 working-on。 


把 if 语句 的 条 件 提取 出 来 成 为 一 个 boolean 类 型 的 本 地 变量 就 能 解决 这 个 不 易 读 的 问题 。 


完成 引入 解释 性 变量 isRollingNumberOdd 的 TODO 的 代码 如 下 所 示 (CM: Finished TODO: Introduce explaining variable isRollingNumberOdd.) : 


public class Game { 
if (players.get (currentPlayer) .isInPenaltyBox()) { 
= // TODO-working-on: Introduce explaining variable isRollingNumberOdd 
= if (rollingNumber % 2 != 0) { 
ae boolean isRollingNumberOdd = rollingNumber % 2 != 0; 
+ if (isRollingNumberOdd) { 
players.get (currentPlayer) .getOutOfPenaltyBox () ; 


“运行 测试 ， 通 过 。 现 在 有 了 if (isRollingNumberOdd) 这 样 的 条 件 语句 ， 可 读 性 就 好 了 很 多 。 剩 下 的 TODO 中 ， 魔 法 数 的 也 很 简单 ， 先 处 理 Game 类 所 有 魔法 数 。 


完成 Game 类 中 所 有 魔法 数 的 TODO 的 代码 如 下 所 示 (CM: Finished all magic number TODOs in class Game.) : 


public class Game { 
public static final int NUMBER OF GOLD COINS TO WON AND GAME OVER = 6; 
public static final int MAX ; NUMBER ( OF ' BYTES | WRITING * TO ( ONE ] FĪLE = 10000000; 
public static final int NUMBER OF FILES TO USE = 1; 
public static final int MAX _NUMBER_OF QUESTIONS = 50; 
public Game() { 
try { 
= // TODO: Magic number 10000000 
一 fileHandler = new FileHandler ("%h/Game-logging.1log", 10000000, 1, true); 
+ fileHandler = new FileHandler ("%h/Game-logging. log" 
+ , MAX NUMBER OF BYTES WRITING TO ONE FILE 
* , NUMBER OF | FILES | TO ) USE, true); 
> // TODO: Magic number 50 
一 for (int i = 0; i < 50; i++) { 
+ for (int i = 0; i < MAX NUMBER OF QUESTIONS; i++) { 
= // TODO: The magic number 6 
private boolean isGameStilliInProgress() { 
a return ! (players.get (currentPlayer) .countGoldCoins() == 6); 
+ return ! (players.get (currentPlayer) .countGoldCoins () == NUMBER OF 
GOLD COINS TO WON AND GAME OVER) ; 


“运行 测试 ， 通 过 。 接 下 来 该 处 理 Player 类 中 的 所 有 魔法 数 了 。” 


完成 Player 类 中 的 所 有 魔法 数 的 TODO 的 代码 如 下 所 示 (CM: Finished all magic number TODOs in class Player.) : 


public class Player { 
public static final int MAX NUMBER OF PLACE = 12; 
public static final int CATEGORY POP 1 = 
public static final int CATEGORY POP 2 = 
public static final int CATEGORY_POP_3 = 
public static final int CATEGORY_SCIENCE 
public static final int CATEGORY SCIENCE : 
public static final int CATEGORY SCIENCE ~ 
public static final int CATEGORY_SPORTS_1 = 
public static final int CATEGORY SPORTS 2 
public static final int CATEGORY_SPORTS_3 = 


十 十 十 十 十 十 十 十 十 十 


public void moveForwardSteps (int steps) { 
this.place += steps; 
= // TODO: Magic number 12 
= if (this.place > 11) this.place -= 12; 
+ if (this.place > MAX NUMBER OF PLACE - 1) this.place -= MAX NUMBER OF PLACE; 
} 
public String getCurrentCategory() { 
= // TODO: Magic number 0, 4, 8, 1, 5, 9, 2, 6, 10 
= if (this.place == 0) return 
= if (this.place ) return 
= if (this.place ) return 
= if (this.place ) return 
- if (this.place ) return 
) 
) 


= if (this.place return "Science"; 
= if (this.place return "Sports"; 
= if (this.place ) return "Sports"; 
= if (this.place 10) return "Sports"; 
+ if (this.place CATEGORY POP 1) return "Pop"; 
十 if (this.place CATEGORY POP 2) return "Pop"; 
+ if (this.place == CATEGORY_POP_3) return "Pop"; 


十 if (this.place == CATEGORY_SCIENCE_1) return "Science"; 
+ if (this.place == CATEGORY SCIENCE 2) return "Science"; 
+ if (this.place == CATEGORY_SCIENCE_3) return "Science"; 
+ if (this.place == CATEGORY SPORTS 1) return "Sports"; 
+ if (this.place CATEGORY SPORTS 2) return "Sports"; 
+ if (this.place == CATEGORY_SPORTS_3) return "Sports"; 
return "Rock"; 3 ~ 
} 
“运行 测试 ， 通 过 。 


要 清除 成 员 变量 isGettingOutOfPenaltyBox， 可 


让 Player 类 的 getOutOfPenaltyBox () 方法 使 


以 先 把 使 
它 。 可 以 先 从 Player 类 的 getOutOfPenaltyBox () 方法 开始 。 


接 下 来 该 处 理 Player 类 的 那个 元 余 的 成 员 变量 jisGettingOutOf-PenaltyBox 了 。 把 它 标 记 为 working-on。” 


isInPenaltyBox instead.) : 


public class Player { 
= public void getOutOfPenaltyBox() { 


= this.isGettingOutOfPenaltyBox = true; 
+ this.isInPenaltyBox = false; 


m=z; 


运行 测试 ， 通 过 。 接 下 来 可 以 在 Game 类 中 把 所 有 与 禁闭 室 相关 的 代码 都 换 成 使 


在 Game 类 中 把 所 有 与 禁闭 室 相关 的 代码 都 换 成 使 


Player.isInPenaltyBox.) : 


public class Game { 


} else { 


这 个 成 员 变 


的 地 方 都 蔡 换 为 使 F 


另 一 个 成 员 变 


islInPenaltyBox， 等 没有 使 


Player 类 的 isInPenaltyBox 成 员 变量 的 代码 。” 


logger. info (players.get (currentPlayer) + " is not getting out 


of the penalty box"); 


= players.get (currentPlayer) .stayInPenaltyBox () ; 
市 players .get (currentPlayer) .sentToPenaltyBox () ; 


} 


public boolean wasCorrectlyAnswered() { 


if (players.get (currentPlayer) .isInPenaltyBox()) { 


} else { 
nextPlayer (); 
return true; 

} 


} else { 


nextPlayer (); 
return true; 


+eerrrrered 


} 


+ 


yi 
) 7 


return currentPlayerGetsAGoldCoinAndSelectNextPlayer () ; 


if (players.get (currentPlayer) .isGettingOutOfPenaltyBox()) { 
return currentPlayerGetsAGoldCoinAndSelectNextPlayer () ; 


return currentPlayerGetsAGoldCoinAndSelectNextPlayer () ; 


通过 。 现 在 到 了 删除 Player 类 中 与 jisGettingOutOfPenaltyBox 相 关 的 所 有 代码 的 时 候 了 。” 


成 员 变量 isGettingOutOfPenaltyBox 的 地 方 后 ， 


清除 


成 员 变 量 isInPenaltyBox 的 代码 如 下 所 示 (CM: Updated the implementation of method Player.getOutOfPenaltyBox () to use field 


Player 类 的 isInPenaltyBox 成 员 变 量 的 代码 如 下 所 示 (CM: Updated all penalty-related code in class Game to use the field 


完成 删除 Player 类 的 成 员 变 量 isGettingOutOfPenaltyBox 的 TODO 的 代码 如 下 所 示 (CM: Removed all isGettingOutOfPenaltyBox-related code from class Player.Finished TODO: Eliminate 


field Play.isGettingOutOfPenaltyBox.) : 


public class Player { 


private boolean isInPenaltyBox = false; 


= // TODO-working-on: Eliminate field Play.isGettingOutOfPenaltyBox 
= private boolean isGettingOutOfPenaltyBox = true; 


public void stayInPenaltyBox() { 
this.isGettingOutOfPenaltyBox = false; 
} 


public boolean isGettingOutOfPenaltyBox () 


{ 


} 


return this.isGettingOutOfPenaltyBox; 


public void sentToPenaltyBox() { 
this.isInPenaltyBox = true; 


} 


运行 测试 ， 通 过 。 


“Player 类 还 没有 进行 单元 测试 呢 ， 添 加 一 个 TODO 吧 。“ 


在 GameTest 类 中 添加 有 关 Player 类 的 单元 测试 的 TODO 的 代码 如 下 所 示 (CM: Added TODO: Write tests for class Player.) : 


public class GameTest { 


+ // TODO: Write tests for class Player 
} 


尚未 测试 的 


不 过 这 个 有 关 给 Player 类 添加 单元 测试 的 TODO 有 些 大 。 最 好 能 分 解 为 几 个 Player 类 的 用 户 意图 ， 再 针对 每 个 用 户 意图 来 编写 单元 测试 。 咱 们 可 以 先 看 看 Player 类 的 
“Player 类 主要 负责 添加 玩家 和 维护 玩家 在 游戏 盘 上 的 位 置 、 钱 包 中 的 金币 数量 和 是 否 在 禁闭 室 的 状态 。 其 中 添加 玩家 和 维护 玩家 钱包 中 的 金币 数量 这 两 个 用 户 意 医 


户 


的 测试 中 体现 出 来 了 。 未 测试 的 


在 游戏 盘 上 的 位 置 的 用 户 意图 ， 可 以 写 2 个 TODO， 一 个 表示 玩家 从 起 点 


就 剩 下 玩家 在 游戏 盘 上 的 位 置 和 玩家 在 游戏 盘 上 移动 的 步 数 与 他 要 回 


q 
[ 


都 有 哪些 ， 然 后 再 写 出 那些 


已 经 在 前 面 那 3 个 有 关 游 戏 如 何 结束 


始 前 


进 1 步 ， 他 所 处 的 位 置 就 是 1; 


一 个 表示 玩家 从 起 点 


系 ， 可 以 写 4 个 TODO， 分 别 表示 玩家 移动 步 数 与 流行 音乐 、 科 学 、 体 育 和 摇滚 音乐 这 4 类 问题 之 间 的 关系 。” 


答 的 问题 类 别 之 间 的 关系 这 两 个 方 


面 。 可 以 针对 这 两 个 方 


H 


来 添加 细 化 


后 的 TODO。 对 于 玩家 


始 前 进 12 步 ， 他 所 处 的 位 置 就 是 0。 对 于 移动 步 数 与 问题 类 别 之 间 的 关 


在 GameTest 类 中 将 一 个 大 TODO 蔡 换 为 6 个 小 TODO 的 代码 如 下 所 示 (CM: Replaced 'TODO: Write tests for class Playerwith 6 TODOs for testing place and category of class Player.) : 


public class GameTest { 


=" // TODO: Write tests for class Player 
+ // TODO: the place should be 1 if the player moves forward 1 step 
+ // TODO: the place should be 0 if the player moves forward 12 steps 


// TODO: the category should be Pop if the player moves 12, 4 or 8 steps 
// TODO: the category should be Science if the player moves 1, 5 or 9 steps 
// TODO: the category should be Sports if the player moves 2, 6 or 10 steps 
// TODO: the category should be Rock if the player moves 3, 7 or 11 steps 


十 十 十 十 十 


“可 以 先 处 理 玩家 移动 1 步 的 TODO。” 


处 理 玩家 移动 1 步 的 TODO 并 编写 测试 的 Assert 部 分 的 代码 如 下 所 示 (CM: Working on TODO: the place should be 1 if the player moves forward 1 step.Wrote an assertion.) : 


public class GameTest { 


// TODO: the place should be 1 if the player moves forward 1 step 
// TODO-working-on: the place should be 1 if the player moves forward 1 step 
@Test 
public void the_place_should_be_1 if the player moves forward 1 step() { 
// Assert 
assertEquals(1, player.getPlace()); 


+ 
十 
fs 
+ 
+ 
条 


“接着 再 写 这 个 测试 的 Act 和 Arrange 部 分 。 运 行 测试 ， 通 过 。” 


完成 玩家 移动 1 步 的 TODO 的 代码 如 下 所 示 (CM: Finished TODO: the place should be 1 if the player moves forward 1 step.) 


public class GameTest { 


// TODO-working-on: the place should be 1 if the player moves forward 1 step 
@Test 
public void the place should be 1 if the _ Player moves forward 1 _ step () { 

// Arrange 

Player player = new Player ("Ben"); 


// Act 
player .moveForwardSteps (1) ; 


+ 
+ 
+ 
+ 
+ 
+ 


// Assert 
assertEquals (1, player.getPlace()); 


“类 似 地 ， 再 处 理 玩家 移动 12 步 的 TODO。” 


处 理 玩家 移动 12 步 的 TODO 并 编写 测试 的 Assert 部 分 的 代码 如 下 所 示 (CM: Working on TODO: the place should be 0 if the player moves forward 12 steps.Wrote an assertion.) : 


public class GameTest { 


// TODO: the place should be 0 if the player moves forward 12 steps 


// TODO-working-on: the place should be 0 if the player moves forward 12 steps 
@Test 
public void the_place_should_be 0 if the player moves forward 12 steps() { 

// Assert 


assertEquals (0, player.getPlace()); 


+++ eee 


完成 玩家 移动 12 步 的 TODO 的 代码 如 下 所 示 (CM: Finished TODO: the place should be 0 if the player moves forward 12 steps.) : 


public class GameTest { 


= // TODO-working-on: the place should be 0 if the player moves forward 12 steps 
@Test 
public void the_place_should_be 0 if the player moves forward 12 steps() { 

// Arrange 

Player player = new Player ("Ben"); 


// Bot 
player .moveForwardSteps (12) ; 


十 十 十 十 十 十 


// Assert 
assertEquals (0, player.getPlace()); 


“运行 测试 ， 通 过 。 接 下 来 该 处 理 玩家 移动 12、4 或 8 步 的 时 候 就 会 被 问 到 流行 音乐 的 问题 类 别 的 TODO 了 。” 


处 理 玩家 移动 12、4 或 8 步 的 时 候 就 会 被 问 到 流行 音乐 的 问题 类 别 的 TODO 并 编写 测试 的 Assert 部 分 的 代码 如 下 所 示 (CM: Working on TODO: the category should be Pop if the player moves 


12, 4 or 8 steps.Wrote an assertion.) : 


public class GameTest { 


// TODO: the category should be Pop if the player moves 12, 4 or 8 steps 


// TODO-working-on: the category should be Pop if the player moves 12, 4 or 8 steps 

@Test 

public void the category should be Pop if the player moves 12 or 4 or 8 steps() { 
// Assert 


assertEquals ("Pop", player.getCurrentCategory()); 


十 十 十 十 十 十 是 


完成 玩家 移动 12、4 或 8 步 的 时 候 就 会 被 问 到 流行 音乐 的 问题 类 别 的 TODO 的 代码 如 下 所 示 (CM: Finished TODO: the category should be Pop if the player moves 12, 4 or 8 steps.) : 


public class GameTest { 


a // TODO-working-on: the category should be Pop if the player moves 12, 4 or 8 steps 
@Test 
public void the category should be Pop if the _ Player moves 12 or 4 or 8 steps() { 
// Assert 
// Arrange 
Player player = new Player ("Ben"); 


// Act, Assert 
player .moveForwardSteps (12) ; 
assertEquals ("Pop", player.getCurrentCategory ()); 


player .moveForwardSteps (4) ; 
assertEquals ("Pop", player.getCurrentCategory ()); 


十 十 十 十 十 十 十 十 十 十 十 1 


player .moveForwardSteps (8) ; 
assertEquals ("Pop", player.getCurrentCategory ()); 


运行 测试 ， 通 过 。 


把 Pop 字 符号 


个 测试 有 3 条 assertEquals () 语句 ， 每 条 语句 都 有 Pop 这 个 字符 串 。 换 名 话说， 这 个 字符 串 寻 


复 了 3 次 。 可 以 提取 一 个 变量 来 消除 


提取 为 变量 以 消除 重复 的 代码 如 下 所 示 (CM: Extracted variable category in a test to remove duplicate code.) : 


public class GameTest { 


public void the category should be Pop if the Player moves 12 or 4 or 8 steps() { 
// Arrange 
Player player = new Player ("Ben"); 
String category = "Pop"; 
// Act, Assert 
player .moveForwardSteps (12) ; 
assertEquals ("Pop", player.getCurrentCategory()); 
assertEquals (category, player.getCurrentCategory ()); 
player .moveForwardSteps (4) ; 
assertEquals ("Pop", player.getCurrentCategory ()); 
assertEquals (category, player.getCurrentCategory()); 
player .moveForwardSteps (8) ; 
assertEquals ("Pop", player.getCurrentCategory()); 
assertEquals (category, player.getCurrentCategory()); 


“运行 测试 ， 通 过 。 现 在 可 以 类 似 地 处 理 玩家 移动 1、5 或 9 步 的 时 候 就 会 被 问 到 科学 的 问题 类 别 的 TODO 了 。 但 是 测试 运行 却 失败 了 。 哦 ， 原 来 Player 类 的 moveForwardsteps () 方法 对 了 


盘 上 移动 的 步 数 是 累积 计算 的 ， 而 不 会 每 次 调用 时 都 清 0， 所 以 需要 修改 有 关 问 题 类 别 的 测试 。” 


处 理 玩家 移动 1、5 或 9 步 的 时 候 就 会 被 问 型 


restarted every time.Will change the category tests.) : 


玩家 在 游戏 


科学 的 问题 类 别 的 TODO 测 试 失败 的 代码 如 下 所 示 (CM: Failed a category test since method Player.moveForwardSteps () is cumulative instead of 


public class GameTest { 


++ 


十 十 十 十 十 十 十 十 十 十 十 十 十 十 


“需要 把 这 4 个 有 关 问 题 类 别 的 用 户 意 


// TODO: the category should be Science if the player moves 1, 5 or 9 steps 
// TODO-working-on: the category should be Science if the player moves 1, 
5 or 9 steps 
@Test 
public void the category should be Science if the player moves 1 or 5 


or 9 steps() { 


// Arrange 
Player player = new Player ("Ben"); 
String category = "Science"; 


// Act, Assert 
player .moveForwardSteps (1) ; 
assertEquals (category, player.getCurrentCategory()); 


player .moveForwardSteps (5) ; 
assertEquals (category, player.getCurrentCategory()); 


player .moveForwardSteps (9) 7 
assertEquals (category, player.getCurrentCategory()); 


测试 中 玩家 移动 的 步 数 换 成 玩家 在 游戏 盘 上 所 处 的 位 置 。” 


[ 


对 。 虽 然 还 是 在 测试 中 调用 Player 类 的 moveForwardSsteps () 方法 来 让 玩家 在 游戏 盘 上 移动 步 数 ， 但 是 需 


让 步 数 凑 成 在 游戏 盘 上 的 相应 的 位 置 。 


把 4 个 有 关 问 题 类 别 的 意图 测试 中 玩家 移动 的 步 数 换 成 玩家 在 游戏 盘 上 所 处 位 置 的 代码 如 下 所 示 (CM: Updated all tests and TODOs about places to use the concept of place.Finished 2 
TODOs about Pop and Science category.) : 


public class GameTest { 


+ 


an 


++ 


@Test 
public void the category should be Pop if the Player moves 12 or 4 or 8 steps() { 
public void the_category_should_be Pop if the player_is in place 0 or 4 or 8() { 
// Arrange 
Player player = new Player ("Ben"); 
String category = "Pop"; 
// Act, Assert 
player .moveForwardSteps (12) ; 
assertEquals (category, player.getCurrentCategory()); 
player.moveForwardSteps (4) ; 
assertEquals (category, player.getCurrentCategory()); 
player .moveForwardSteps (8) 7 
player .moveForwardSteps (4) 7 
assertEquals (category, player.getCurrentCategory ()); 
} 
// TODO-working-on: the category should be Science if the player moves 1, 
5 or 9 steps 


@Test 

public void the category should be Science if the Player moves 1 or 5 or 
9 steps() { 

public void the_category_should be Science if the player is in place 1 or 
5 or 9() + 
/7 Arrange 
Player player = new Player ("Ben"); 
String category = "Science"; 


// Act, Assert 

player .moveForwardSteps (1) ; 

assertEquals (category, player.getCurrentCategory ()); 

player .moveForwardSteps (5) ; 

player .moveForwardSteps (4) 7 

assertEquals (category, player.getCurrentCategory()); 

player .moveForwardSteps (9) 7 

player .moveForwardSteps (4) ; 

assertEquals (category, player.getCurrentCategory()); 
} 
// TODO: the category should be Sports if the player moves 2, 6 or 10 steps 
// TODO: the category should be Rock if the player moves 3, 7 or 11 steps 
// TODO: the category should be Sports if the player is in place 2 or 6 or 10 
// TODO: the category should be Rock if the player is in place 3 or 7 or 11 


“运行 测试 ， 通 过 。 类 似 地 ， 可 以 处 理 有 关 体育 和 摇滚 音乐 的 问题 类 别 的 TODO。“ 


完成 有 关 体育 和 摇滚 音乐 的 问题 类 别 的 TODO 的 代码 如 下 所 示 (CM: Finished 2 TODOs about Sports and Rock categories.) 


public class GameTest { 


// TODO: the category should be Sports if the player is in place 2 or 6 or 10 
// TODO: the category should be Rock if the player is in place 3 or 7 or 11 
@Test 
public void the category should be _ Sports if the Player is in place 2 or 

6 or 10() { 

/7 Arrange 

Player player = new Player ("Ben"); 

String category = "Sports"; 


// Act, Assert 
player .moveForwardSteps (2) 7 


assertEquals (category, player .getCurrentCategory () ) 7 


player .moveForwardSteps (4) ; 
assertEquals (category, player .getCurrentCategory () ) 7 


player .moveForwardSteps (4) 7 
assertEquals (category, player.getCurrentCategory()); 
} 


@Test 

public void the category should be Rock if the Player is in place 3 or 7 or_11() { 
// Arrange 
Player player = new Player ("Ben"); 
String category = "Rock"; 


// Act, Assert 
player .moveForwardSteps (3) 7 
assertEquals (category, player.getCurrentCategory()); 


player .moveForwardSteps (4) 7 
assertEquals (category, player.getCurrentCategory()); 


player .moveForwardSteps (4) 7 
assertEquals (category, player.getCurrentCategory()); 


十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 十 


“运行 测试 ， 通 过 。 现 在 除了 两 个 later 的 TODO 之 外 ， 所 有 TODO 都 处 理 完了 。 现 在 TODO 不 像 以 前 那么 多 了 ， 而 且 手 上 也 没有 正在 处 理 的 任务 ， 所 以 咱们 可 以 发 现代 码 “ 腐 臭 ”就 随时 修改 ， 不 用 再 
写 TODO 了 。 我 注意 到 有 些 import 语 句 没有 被 用 到 ， 可 以 清理 一 下 。” 


清理 未 被 用 到 的 import 语 句 的 代码 如 下 所 示 (CM: Cleaned up unused imports.) : 


import java.util.ArrayList; 
-import java.util.LinkedList; // in file Game.java 
import java.util.logging.FileHandler; 


import static org.junit.Assert.assertFalse; 
-import static org.junit.Assert.assertTrue; // in file GameTest.java 


运行 测试 ， 通 过 。 


“还 有 什么 地 方 可 以 重 构 呢 ?“ 


观察 一 下 Game 类 的 构造 器 ， 看 看 还 有 什么 问题 。 


Game 类 的 构造 器 代码 如 下 所 示 : 


public Game() { 
try { 
fileHandler = new FileHandler ("%h/Game-logging.log" 
, MAX NUMBER OF BYTES WRITING TO ONE FILE 
, NUMBER OF FILES TO USE, true); ` 
fileHandler.setFormatter (new SimpleFormatter ()); 
} catch (IOException e) { 
e.printStackTrace () 7 
} 
logger.addHandler (fileHandler) ; 
for (int i = 0; i < MAX NUMBER OF QUESTIONS; i++) { 
questionMaker.addPopQuestion ("Pop Question " + i); 
questionMaker.addScienceQuestion ( ("Science Question " + i)); 
questionMaker.addSportsQuestion(("Sports Question " + i)); 
questionMaker.addRockQuestion ("Rock Question " + i); 


“ 没 看 出 什么 问题 呀 。” 


函数 中 的 语句 都 要 在 同一 抽象 层次 上 。[ 包 但 是 在 Game 类 的 构造 器 中 ， 既 有 question-Maker.addPopQuestion () 这 样 较 高 层次 的 语句 ， 也 有 logger.addHandler () 这 样 较 低层 次 的 语句 。 为 了 便于 
阅读 ， 可 以 把 这 个 构造 器 中 有 关 设 置 日 志文 件 和 准备 问题 的 两 段 代码 提取 出 来 成 为 两 个 方法 ， 使 得 每 个 方法 中 的 语句 都 在 同一 个 抽象 层次 上 。 


将 Game 类 的 构造 器 中 两 段 代码 提取 成 两 个 方法 的 代码 如 下 所 示 : 


public Game() { 
logToAFile (); 
prepareQuestions (); 


private void logToAFile() { 
try { 
fileHandler = new FileHandler ("%h/Game-logging.1log" 
, MAX NUMBER OF BYTES WRITING TO ONE FILE 
, NUMBER OF FILES TO USE, true); ` 
fileHandler.setFormatter (new SimpleFormatter () ) 7 
} catch (IOException e) { 
e.printStackTrace () 7 
} 
logger.addHandler (fileHandler); 


private void prepareQuestions() { 
for (int i = 0; i < MAX NUMBER OF QUESTIONS; i++) { 
questionMaker.addPopQuestion ("Pop Question " + i); 
questionMaker.addScienceQuestion ( ("Science Question " + i)); 
questionMaker.addSportsQuestion(("Sports Question " + i)); 
questionMaker.addRockQuestion ("Rock Question " + i); 


“运行 测试 ， 通 过 。 我 注意 到 Game 类 的 私有 方法 howManyPlayers () 没有 被 使 用 过 ， 可 以 大 胆 地 删除 它 。 写 好 Commit Message， 等 以 后 需要 时 再 从 版 本 管理 系统 中 找 出 来 也 不 迟 。” 


在 Game 类 中 删除 未 被 使 用 过 的 方法 howManyPlayers () 的 代码 如 下 所 示 (CM: Removed unused method Game.howManyPlayers () .) : 


public class Game { 
a private int howManyPlayers() { 
一 return players.size(); 


“Game 类 的 roll () 方法 有 两 层 幅 套 的 if-else 语 句 ， 读 起 来 挺 费 劲 、 有 没有 重 构 的 好 办 法 ?” 


Game 类 的 roll () 方法 


构 前 的 代码 如 下 所 示 : 


public void roll(int rollingNumber) { 
logger .info (players .get (currentPlayer) + " is the current player"); 
logger.info("They have rolled a " + rollingNumber) ; 
if (players.get (currentPlayer) .isInPenaltyBox()) { 
boolean isRollingNumberOdd = rollingNumber % 2 
if (isRollingNumberOdd) { 
players .get (currentPlayer) .getOutOfPenaltyBox () ; 
logger. info (players.get (currentPlayer) + " is getting out of 
the penalty box"); 
currentPlayerMovesToNewPlaceAndAnswersAQuestion (rollingNumber) ; 
} else { 
logger.info (players.get (currentPlayer) + " is not getting out 
of the penalty box"); 
players .get (currentPlayer) .sentToPenaltyBox () ; 


!= 0; 


} else { 
current PlayerMovesToNewPlaceAndAnswersAQuestion (rollingNumber) ; 
} 
} 


“有 的 。 可 以 使 用 卫 语句 (guard clause) 来 替代 嵌 套 的 条 件 表达 式 Sl， 即 只 有 一 层 条 件 判断 ， 只 要 某 个 条 件 内 部 的 语句 执行 完毕 ， 就 立即 执行 return 语 句 返 回 ， 退 出 方法 。 因 为 只 有 一 层 条 件 判断 ， 


所 以 有 利于 阅读 代码 。” 


Game 类 的 roll () 方法 使 用 卫 语 句 


铭 后 的 代码 如 下 所 示 : 


public void roll(int rollingNumber) { 

logger.info (players.get (currentPlayer) + " is the current player"); 

logger.info("They have rolled a " + rollingNumber) ; 

if (!players.get (currentPlayer) .isInPenaltyBox()) { 
currentPlayerMovesToNewPlaceAndAnswersAQuestion (rollingNumber) ; 
return; 

} 

boolean isRollingNumberOdd = rollingNumber % 2 != 0; 

if (isRollingNumberOdd) { 
players .get (currentPlayer) .getOutOfPenaltyBox () 7 
logger .info (Players.get (currentPlayer) + " is getting out of the 

penalty box"); 

currentPlayerMovesToNewPlaceAndAnswersAQuestion (rollingNumber) ; 
return; 

} 

logger.info (players.get (currentPlayer) + " is not getting out of the 
penalty box"); 

players.get (currentPlayer) .sentToPenaltyBox () ; 


“运行 测试 ， 通 过 。Game 类 的 wasCorrectlyAnswered () 方法 中 ， 有 一 句 ‘return true; ”语句 。 这 句 话 在 上 下 文中 的 含义 其 实 是 玩家 还 被 关 在 禁闭 室 里 ， 所 以 这 个 玩家 就 不 能 回答 问题 从 而 赢得 
6 进而 结束 游戏 ， 所 以 返回 游戏 仍旧 可 以 继续 的 状态 。 这 么 多 的 内 容 用 一 句 “return true; ” 自然 表达 不 清 ， 但 可 以 把 true 提 取 成 一 个 解释 性 的 变量 ， 来 增强 表达 性 ， 以 利于 阅读 .。“ 


在 Game 类 的 wasCorrectlyAnswered () 方法 中 提取 解释 性 的 变量 的 代码 如 下 所 示 (CM: Introduced explaining variable in method Game.wasCorrectlyAnswered () .) 


public class Game { 


public boolean wasCorrectlyAnswered() { 
if (players.get (currentPlayer) .isInPenaltyBox()) { 
nextPlayer (); 
= return true; 
+ boolean theGameIsStillInProgress = true; 
+ return theGameIsStillInProgress; 
} 
return currentPlayerGetsAGoldCoinAndSelectNextPlayer () ; 


“运行 测试 ， 通 过 。 在 Game 类 的 wasCorrectlyAnswered () 方法 中 提取 了 解释 性 的 变量 ， 那 么 相应 地 在 wrongAnswer () 方法 中 返回 同样 含义 的 true 的 地 方 也 需要 这 样 做 。” 


在 Game 类 的 wrongAnswer () 方法 中 提取 解释 性 的 变量 的 代码 如 下 所 示 (CM: Introduced explaining variable in method Game.wrongAnswer () .) 


public class Game { 
public boolean wrongAnswer() { 

logger.info("Question was incorrectly answered") ; 
logger. info (players.get (currentPlayer) + " was sent to the penalty box"); 
players.get (currentPlayer) .sentToPenaltyBox () ; 
nextPlayer (); 

= return true; 

boolean theGameIsStillInProgress = true; 

+ return theGameIsStillInProgress; 


+ 


“运行 测试 ， 通 过 。 在 Player 类 的 getCurrentCategory () 方法 中 ， 问 题 类 别 的 字符 串 都 可 以 提取 成 常量 ， 以 消除 重复 代码 。” 


在 Player 类 的 getCurrentCategory () 方法 中 提取 问题 类 别 字 符 串 作为 常量 的 代码 如 下 所 示 (CM: Extracted constants of categories in class Player.) 


public class Player { 


+ public static final String POP = "Pop"; 
+ public static final String SCIENCE = "Science"; 
+ public static final String SPORTS 
+ public static final String ROCK = "Rock"; 


public String getCurrentCategory() { 


- if (this.place == CATEGORY_POP_1) return "Pop"; 

一 if (this.place CATEGORY POP 2) return "Pop"; 

- if (this.place CATEGORY POP 3) return "Pop"; 

= if (this.place CATEGORY _SCIENCE_1) return "Science"; 
= if (this.place CATEGORY SCIENCE 2) return "Science"; 
= if (this.place CATEGORY SCIENCE 3) return "Science"; 
一 if (this.place CATEGORY SPORTS 1) return "Sports"; 
- if (this.place CATEGORY SPORTS 2) return "Sports"; 


= | 2) 
- if (this.place CATEGORY_SPORTS_3) return "Sports"; 


return "Rock"; 


+ if (this.place == CATEGORY POP 1) return POP; 

+ if (this.place == CATEGORY POP 2) return POP; 

+ if (this.place == CATEGORY POP 3) return POP; 

+ if (this.place == CATEGORY SCIENCE 1) return SCIENCE; 
+ if (this.place == CATEGORY SCIENCE 2) return SCIENCE; 
+ if (this.place == CATEGORY SCIENCE 3) return SCIENCE; 
+ if (this.place CATEGORY _SPORTS_1) return SPORTS; 
+ if (this.place == CATEGORY SPORTS 2) return SPORTS; 
+ if (this.place == CATEGORY_SPORTS 3) return SPORTS; 
+ return ROCK; a T 


“运行 测试 ， 通 过 。 现 在 在 GameTest 这 个 测试 类 中 ， 共 有 13 个 测试 ， 也 算 一 个 大 类 了 。 我 看 可 以 根据 这 13 个 测试 相互 之 间 的 相关 性 ， 提 取 一 些 相关 的 测试 到 新 创建 的 小 一 些 的 测试 类 中 ， 以 消除 过 大 


BUX BR.” 


将 GameTest 类 中 与 问题 相关 的 测试 提取 到 QuestionMakerTest 测 试 类 中 的 代码 如 下 所 示 (CM: Created test class QuestionMakerTest and moved all question-related tests into it.) : 


+public class QuestionMakerTest { 


+ QTest 

+ public void add_two_pop_questions_and_could_remove_the_first_one() { 

S i 

+ 

+ @Test 

+ public void add two science questions and could remove the first one() { 
a ) 

+ 

+ @Test 

+ public void add_two_sports_questions_and_could_remove_the_first_one() { 
+ } 

+ 

+ @Test 

+ public void add_two_rock_questions_and_could_remove_the_first_one() { 

+ } 

+ 

+} 


“由 于 现在 有 了 两 个 测试 类 ， 所 以 可 以 按 Alt+ 1 快捷 键 把 光标 定位 在 Project 窗 口 的 tesUVjavay/kata.trivia 之 上 ， 然 后 按 Ctrl+Shift+F10 组 合 键 来 运行 测试 ， 通 过 。 类 似 地 ， 可 以 把 GameTest 类 中 与 玩家 
在 游戏 盘 上 的 位 置 和 问题 类 别 相关 的 测试 都 提取 到 新 创建 的 PlayerTest 测 试 类 中 。 " 


把 GameTest 类 中 与 玩家 在 游戏 盘 上 的 位 置 和 问题 类 别 相关 的 测试 都 提取 到 新 创建 的 PlayerTest 测 试 类 中 的 代码 如 下 所 示 (CM: Created test class PlayerTest and moved all place-and category- 


related tests into it.) : 


+public class PlayerTest { 
+ @Test 
+ public void the place should be 1 if the player moves forward 1 step() { 


+ } 

+ 

+ @Test 

+ public void the place should be 0 if the player moves forward 12 steps() { 

+ } 

+ 

+ @Test 

+ public void the_category_should_be Pop if the player is in place 0 or 4 or 8() { 

+ } 

+ 

+ QTest 

十 public void the category should be _ Science if the Player is in Place 1 or 
S_or_9() + 

+ } 

+ 

+ @Test 

+ public void the_category_should_be Sports if the Player is in Place 2 or 
6 or 10() { 

+ } 

+ 

+ @Test 

+ public void the category should be Rock if the player is in place 3 or 7 or _11() { 

+ } 

+} 


运行 测试 ， 通 过 。 可 以 把 GameTest、PlayerTest 和 QuestionMakerTest 这 3 个 测试 类 中 的 Arrange 部 分 的 代码 都 提取 到 @Before 标 注 的 方法 中 ， 以 消除 


复 代 码 。” 


在 GameTest 类 中 将 Arrange 部 分 提取 到 @Before 标 注 的 方法 后 的 代码 如 下 所 示 (CM: Moved initialization code to @Before in test class GameTest.) : 


public class GameTest { 
private Game game = null; 
private boolean isGameStillInProgress = true; 
@Before 
public void initialize() { 
// Arrange 
game = new Game (); 
game.add ("Chet"); 
isGameStillInProgress = true; 
} 
@Test 
public void the game should be over if a player rolls the _dice_and_answers_ 
each question correctly for 6 times() { 
// Act F eE ee 
for (int i = 0; i < 6; i++) { 
game.roll (1); 
isGameStillInProgress = game.wasCorrectlyAnswered () ; 


} 
// Assert 
assertFalse (isGameStillInProgress); 

} 

@Test 

public void the game should be over if a player rolls the dice for 7 times_ 
and answers the question wrongly for 1 time followed by an odd rolling 
number but then correctly for 6 times() { ` se 


} 

@Test 

public void the game should be over if a player rolls the dice for 8 times_ 
and answers the question wrongly for 1 time followed by an even rolling 
number but then correctly for 7 times with odd rolling numbers() { 


在 PlayerTest 类 中 将 Arrange 部 分 提取 到 @Before 标 注 的 方法 后 的 代码 略 (CM: Moved initialization code to @Before in test class PlayerTest.) 。 


在 QuestionMakerTest 类 中 将 Arrange 部 分 提取 到 @Before 标 注 的 方法 后 的 代码 略 (CM: Moved initialization code to @Before in test class QuestionMakerTest.) 。 


“运行 测试 ， 通 过 。 在 QuestionMakerTest 类 中 ， 第 1 个 问题 的 字符 串 在 添加 问题 和 断言 判断 时 分 别 出 现 了 一 次 ， 形 成 了 重复 代码 。 可 以 将 


提取 成 常量 来 消除 重复 代码 。” 


在 QuestionMakerTest 类 中 提取 常量 以 消除 


的 代码 如 下 所 示 (CM: Extracted constants in test class QuestionMakerTest to eliminate duplicate code.) : 


public class QuestionMakerTest { 

+ public static final String POP_QUESTION_1 = "Pop Question 1"; 

+ public static final String SCIENCE QUESTION 1 = "Science Question 1"; 
+ public static final String SPORTS QUESTION I = "Sports Question 1"; 


把 


public static final String ROCK QUESTION 1 = "Rock Question 1"; 


@Test 
me void add two pop_ questions and could remove the first one() { 
Act 
questionMaker .addPopQuestion ("Pop Question 1"); 
questionMaker.addPopQuestion (POP QUESTION 1); 
questionMaker .addPopQuestion ("Pop Question 2"); 
// Assert 
assertEquals ("Pop Question 1", questionMaker.removeFirstPopQuestion()); 
assertEquals (POP QUESTION 1, questionMaker.removeFirstPopQuestion()); 


云 行 测试 ， 通 过 。 仔 细 观 察 一 下 Game 类 的 构造 器 的 第 2 条 准备 提问 的 语句 pe Oa 


里 面 呢 ? 可 以 把 准备 提问 的 语句 从 Game 类 的 构造 器 中 移动 到 QuestionMaker 类 的 构造 器 中 。 


public class Game { 


public static final int MAX NUMBER OF QUESTIONS = 50; 


public Game() { 
logToAFile (); 
prepareQuestions () 7 


} 


private void prepareQuestions () { 
for (int i = 0; i < MAX_NUMBER OF QUESTIONS; i++) { 
questionMaker. addPopQuestion ("Pop Question " + i); 
questionMaker.addScienceQuestion(("Science Question " + i)); 
questionMaker.addSportsQuestion(("Sports Question " + i)); 
questionMaker.addRockQuestion ("Rock Question " + i); 


} 


public class QuestionMaker { 


+ 


++++++++; 


public static final int MAX NUMBER OF QUESTIONS = 50; 


public QuestionMaker() { 
for (int i = 0; i < MAX_NUMBER OF QUESTIONS; i++) { 
addPopQuestion("Pop Question " + i); 
addScienceQuestion(("Science Question " + i)); 
addSportsQuestion(("Sports Question " + i)); 
addRockQuestion ("Rock Question " + i); 


。 为 什么 准备 提问 的 语句 会 放 到 Game 类 的 构造 器 里 面 ， 而 不 是 放 在 QuestionMaker 类 的 构 


提问 的 语句 从 Game 类 的 构造 器 中 移动 到 QuestionMaker 类 的 构造 器 中 的 代码 如 下 所 示 (CM: Moved question preparation code from class Game to QuestionMaker.) : 


QuestionMakerTest 测 试 。 因 为 


“运行 测试 ， 失 败 ! 失败 的 原因 是 刚才 修改 了 QuestionMaker 类 的 构造 器 ， 使 得 QuestionMaker 类 的 对 象 一 旦 创建 就 会 在 4 类 问题 中 的 每 一 类 问题 中 添加 50 个 问题 。 基 于 这 种 情况 ， 需 要 修改 一 下 


时 


可 题 在 QuestionMaker 对 象 创建 时 都 已 经 添加 好 了 ， 所 以 在 测试 中 就 不 


添加 问题 ， 而 只 要 测 


由 二 全 


Be. 


正确 删除 第 1 个 问题 就 可 以 了 。” 


修改 QuestionMaker 类 的 测试 使 得 不 再 添加 问题 的 代码 如 下 所 示 (CM: Updated test class QuestionMakerTest to adapt the fact that the questions had been added by its constructor.) : 


public class QuestionMakerTest { 


Correctly () ， 后 者 命名 为 answeredWrong () 似乎 更 好 一 些 。 


个 late 


private QuestionMaker questionMaker = null; 
@Before 
public void initialize() { 
// Arrange 
questionMaker = new QuestionMaker () 7 
} 
@Test 
public void the first pop question added by constructor could be removed() { 
// Act, Assert 
assertEquals ("Pop Question 0", questionMaker.removeFirstPopQuestion()); 
} 
@Test 
public void the first : science question i added by constructor í could } be_removed() { 
// Act, Assert 


assertEquals ("Science Question 0", questionMaker.removeFirstScienceQuestion ()); 


} 
@Test 
public void the first sports question added by constructor could be removed() { 
// Act, Assert 
assertEquals ("Sports Question 0", questionMaker.removeFirstSportsQuestion()); 
} 
@Test 
public void the first rock question added by constructor could be removed() { 
// Act, Assert 
assertEquals ("Rock Question 0", questionMaker.removeFirstRockQuestion()); 


“运行 测试 ， 通 过 。 在 Game 类 中 ，wasCorrectlyAnswered () 和 wrongAnswer () 这 两 个 方法 虽然 在 功能 


DH 


[的 TODO,， 来 记录 此 事 ， 待 以 后 条 件 成 熟 时 再 修改 。” 


属于 同一 层 


， 但 二 者 的 命名 风格 却 不 一 致 。 如 果 将 前 者 命名 为 answered- 


为 本 次 编程 操练 不 会 修改 客户 端 代码 ， 而 这 两 个 方法 又 被 客户 端 所 调用 ， 所 以 二 者 的 命名 不 会 被 修改 。 即 使 是 这 样 ， 我 还 是 愿意 添加 两 


在 Game 类 中 添加 两 个 有 关 命 名 的 later 的 TODO 如 下 所 示 (CM: Added 2 TODO-laters for suggestions on the names of interface of class Game.) : 


public class Game { 


+ 


// TODO-later: The name of method Game.wasCorrectlyAnswered() should be 
Game .answeredCorrectly () 
public boolean wasCorrectlyAnswered() { 


// TODO-later: The name of method Game.wrongAnswer() should be Game. 
answeredWrong () 
public boolean wrongAnswer() { 


“好 了 ， 终 于 要 实现 咱们 在 做 这 个 编程 题目 最 开始 时 所 描述 的 那个 新 特性 了 : 正在 被 关 禁 闭 的 玩家 ， 若 掷 出 了 除 4 之 外 的 任何 点 数 ， 都 会 被 从 禁闭 室 里 释放 出 来 ; 若 搓 出 了 4， 则 还 要 继续 被 关 禁 闭 。” 


“因为 新 特性 要 求 被 关 禁 闭 的 玩家 从 禁闭 室 被 释放 出 来 的 条 件 是 掷 出 了 非 4 的 色 子 ， 这 与 原来 掷 出 奇数 的 色 子 的 条 件 不 一 致 ， 所 以 要 更 新 原来 的 测试 ， 来 与 新 特性 保持 一 致 。” 


在 GameTest 类 中 更 新 两 个 含有 玩家 从 禁闭 室 释放 出 来 的 测试 来 与 新 特性 保持 一 致 的 代码 如 下 所 示 (CM: Updated two tests according to the new feature TODO.) : 


public class GameTest { 


+ 


@Test 

public void the game should be over if a player rolls the dice for 7 
times and answers the question wrongly for I time followed by an odd_ 
rolling 1 number 1 but then correctly for 6 times() { 

public void the game should be_over_if a player_rolls the dice for 7 
times and answers the question i wrongly; for I time followed | by a 
rolling number which is not 4 but_then_correctly for 6 times CPt: 


// Bot 
game.roll(1); 
game .wrongAnswer () ; 
game.roll(1); 
+ game.roll (6); 
game .wasCorrectlyAnswered () ; 
for (int i = 0; i < 5; i++) { 
game.roll(1); 


@Test 
public void the game should be over if a player rolls the dice for 8_ 
times and answers the question wrongly for I time followed by an even 
rolling ı number 1 but then 1 Correctly for 7 times with odd | rolling 1 numbers() { 
+ public void the game should be over _if a player_rolls the dice for 8 times_ 
and answers the > question wrongly _: for 1 time followed | by . a | rolling_ 
number which is 4 but then correctly for 7 times with odd rolling numbers fki 
// Act 
game.roll(1); 
game .wrongAnswer () ; 
game.roll(2); 
+ game.roll (4); 
game .wasCorrectlyAnswered () ; 
for (int i = 0; i < 6; i++) { 
game.roll(1); 


+ // TODO-new-feature-working-on: The player will not be getting out of the 
penalty box when the rolling number is 4 


“运行 测试 ， 只 有 那个 搓 了 7 次 色 子 其 中 有 一 次 被 关 禁 闭 之 后 又 掷 出 非 4 色 子 的 测试 失败 ， 其 他 测试 运行 通过 。 其 原因 是 刚刚 只 根据 新 特性 更 新 了 测试 代码 ， 还 未 更 新 生产 代码 。 刚 刚 更 新 的 两 个 测试 
中 ， 其 中 一 个 根据 新 特性 编写 的 测试 的 数据 恰恰 也 满足 原 有 的 逻辑 ， 所 以 测试 运行 碰巧 通过 。 要 让 那个 失败 的 测试 运行 通过 ， 只 要 在 Game 类 的 roll () 方法 中 ， 把 原先 计算 所 掷 点 数 是 奇数 的 地 方 ， 换 成 非 
4 就 可 以 了 。 " 


在 Game 类 的 roll () 方法 中 ， 把 原先 计算 所 掷 点 数 是 奇数 的 地 方 换 成 非 4 的 代码 如 下 所 示 (CM: Finished the new feature TODO.) : 


public class Game { 
a public void roll(int rollingNumber) { 


boolean isRollingNumberOdd = rollingNumber % 2 != 0; 

if (isRollingNumberOdd) { 

boolean isRollingNumberForGettingOutOfPenaltyBox = rollingNumber != 4; 

$ if (isRollingNumberForGettingOutOfPenaltyBox) { 

players.get (currentPlayer) .getOutOfPenaltyBox () ; 

logger.info(players.get (currentPlayer) + " is getting out of the 
penalty box"); 


+ 


“运行 测试 ， 通 过 。 新 特性 完成 了 ， 咱 们 这 个 编程 题目 也 将 告 一 段落 了 。” 


为 了 体会 一 


构 的 成 果 ， 不 妨 把 末 


构 后 的 测试 代码 和 各 个 生产 代码 的 类 完整 地 列 出 来 ， 与 


构 前 列 出 的 Game 类 的 代码 作 一 对 照 。 


GameTest 测 试 类 的 代码 如 下 所 示 : 


public class GameTest { 
private Game game = null; 
private boolean isGameStillInProgress = true; 
@Before 
public void initialize() { 
// Arrange 
game = new Game (); 
game.add ("Chet"); 
isGameStillInProgress = true; 
} 
@Test 
public void the_game_should_be over if a player rolls the _dice_and_answers_ 
each question . correctly - for | 6 ) times () { 


// Act 
for (int i = 0; i < 6; i++) { 
game.roll (1); 


isGameStillInProgress = game.wasCorrectlyAnswered () ; 


} 
// Assert 
assertFalse (isGameStillInProgress); 
} 
@Test 
public void the game should be over if _a player | rolls the dice for 7 times_ 
and_answers_the_question_wrongly for 1 time followed by a rolling_ 
number 1 which ; is not 4 but then | correctly . for_ 6 times() { 
// Act” 
game.roll(1); 
game .wrongAnswer () ; 
game.roll (6); 
game .wasCorrectlyAnswered () ; 
for (int i = 0; i < 5; i++) { 
game.roll (1); 
isGameStillInProgress = game.wasCorrectlyAnswered () ; 


} 
// Assert 
assertFalse (isGameStillInProgress); 
} 
@Test 
public void the game should be over if a player | rolls the dice for 8_times 
and answers the question wrongly for 1 time followed by a rolling number 
which TNE but i then correctly for 7 | times with odd | rolling. numbers () { 
// Bot 
game.roll(1); 
game .wrongAnswer () ; 
game.roll (4); 
game .wasCorrect1lyAnswered () ; 
for (int i = 0; i < 6; i++) { 
game.roll(1); 
isGameStillInProgress = game.wasCorrectlyAnswered () ; 


} 
// Assert 
assertFalse (isGameStillInProgress) ; 


PlayerTest 测 试 类 的 代码 如 下 所 示 : 


public class PlayerTest { 
private Player player = null; 
private String category = null; 
@Before 
public void initialize() { 
// Berange 
player = new Player ("Ben"); 


@Test 

public void the place should be 1 if the player moves forward 1 step() { 
/ Act a pene as at B= a z ATS 
player.moveForwardSteps (1) ; 


// Rssert 
assertEquals (1, player.getPlace()); 


} 


@Test 

public void the place should be 0 if the player moves forward 12 steps() 
// Bet 
player .moveForwardSteps (12) ; 
// Assert 


assertEquals(0, player.getPlace()); 


} 
@Test 


public void the_category_should_be Pop if the Player is _ in place 0 or 4 or 8() 


// Arrange 

category = "Pop"; 

// Act, Assert 

player .moveForwardSteps (12) ; 

assertEquals (category, player.getCurrentCategory () ) ; 
player.moveForwardSteps (4) ; 

assertEquals (category, player.getCurrentCategory ()); 
player .moveForwardSteps (4) ; 

assertEquals (category, player.getCurrentCategory () ) ; 


} 


@Test 

public void the_category_should_be Science if the player is in Place 1 or 
5_or_9() { 
// Berange 
category = "Science"; 


// Act, Assert 

player .moveForwardSteps (1) ; 

assertEquals (category, player.getCurrentCategory ()); 
player .moveForwardSteps (4) ; 

assertEquals (category, player.getCurrentCategory ()); 
player .moveForwardSteps (4) ; 

assertEquals (category, player.getCurrentCategory ()); 


} 
@Test 


{ 


{ 


public void the_category_should_be Sports_if the Player is in place 2 or 6 or 10() 
// Arrange 
category = "Sports"; 
// Act, Assert 
player.moveForwardSteps (2) ; 
assertEquals (category, player.getCurrentCategory()); 
player .moveForwardSteps (4) ; 
assertEquals (category, player.getCurrentCategory ()); 
player .moveForwardSteps (4) ; 
assertEquals (category, player.getCurrentCategory ()); 


} 
@Test 


public void the_category_should_be Rock if the player is in place 3 or 7 or 11() 


// Arrange 

category = "Rock"; 

// Act, Assert 

player .moveForwardSteps (3) ; 

assertEquals (category, player.getCurrentCategory ()); 
player .moveForwardSteps (4) ; 

assertEquals (category, player.getCurrentCategory ()); 
player.moveForwardSteps (4) ; 

assertEquals (category, player.getCurrentCategory ()); 


{ 


{ 


QuestionMakerTest 测 试 类 的 代码 如 下 所 示 : 


public class QuestionMakerTest { 
private QuestionMaker questionMaker = null; 


@Before 


public void initialize() { 
// Arrange 
questionMaker = new QuestionMaker (); 


} 
@Test 


public void the first pop question added by constructor could be removed() 


// Act, Assert 


assertEquals ("Pop Question 0", questionMaker.removeFirstPopQuestion()); 


} 
@Test 


public void the_first_science_question_added_by_constructor_could_be_removed() 


// Act, Assert 


assertEquals ("Science Question 0", questionMaker.removeFirstScienceQuestion ()); 


} 
@Test 


{ 


public void the first sports question added by constructor could be removed() { 
// Act, Assert 


assertEquals ("Sports Question 0", questionMaker.removeFirstSportsQuestion ()); 


} 
@Test 


public void the first rock question added by constructor could be removed() { 


// Act, Assert 


assertEquals ("Rock Question 0", questionMaker.removeFirstRockQuestion()); 


{ 


Game 类 的 代码 如 下 所 示 : 


public class Game { 
public static final int NUMBER OF GOLD COINS TO WON AND GAME OVER 


public static final int MAX NUMBER OF BYTES WRITING TO ONE FILE = 10 


public static final int NUMBER_OF FILES TO USE = 1; 


private final QuestionMaker questionMaker = new QuestionMaker (); 
private ArrayList<Player> players = new ArrayList<Player>(); 
private int currentPlayer = 0; 
private static Logger logger = Logger.getLogger ("kata.trivia.Game") ; 
private static FileHandler fileHandler = null; 
public Game() { 

logToAFile (); 
} 
private void logToAFile() { 


try { 


fileHandler = new FileHandler ("%h/Game-logging.1log" 
, MAX NUMBER OF BYTES WRITING TO ONE FILE 
, NUMBER OF FILES TO USE, true); ` 
fileHandler.setFormatter (new SimpleFormatter ()); 


} catch (IOException e) { 


} 


e.printStackTrace (); 


logger.addHandler (fileHandler) ; 


public void add 
players.add 
logger.info 
logger.info 


} 


String playerName) { 
new Player (playerName) ) ; 
playerName + " was added"); 


public void roll(int rollingNumber) { 


logger .info(players.get (currentPlayer) + " is the current player"); 


logger.info("They have rolled a " + rollingNumber) ; 
if (!players.get (currentPlayer) .isInPenaltyBox()) { 


} 


boolean isRollingNumberForGettingOutOfPenaltyBox = rollingNumber != 4; 


current PlayerMovesToNewPlaceAndAnswersAQuestion (rollingNumber) ; 


return; 


if (isRollingNumberForGettingOutOfPenaltyBox) { 


players .get (currentPlayer) .getOutOfPenaltyBox () ; 


"The total amount of players is " + players.size()); 


logger.info (Players.get (currentPlayer) + " is getting out of the 
penalty box"); 
current PlayerMovesToNewPlaceAndAnswersAQuestion (rollingNumber) ; 
return; 
} 
logger.info (players.get (currentPlayer) + " is not getting out of the 
penalty box"); 
players .get (currentPlayer) .sentToPenaltyBox () ; 
} 
private void currentPlayerMovesToNewPlaceAndAnswersAQuestion(int rollingNumber) { 
players .get (currentPlayer) .moveForwardSteps (rollingNumber) ; 
logger. info (players.get (currentPlayer) 
+ "'s new location is " 
+ players.get (currentPlayer) .getPlace()); 
logger.info("The category is " + players.get (currentPlayer) .getCurrentCategory()); 
askQuestion (); 
} 
private void askQuestion() { 
if (players.get (currentPlayer) .getCurrentCategory() == "Pop") 
logger.info (questionMaker .removeFirstPopQuestion()); 
if (players.get (currentPlayer) .getCurrentCategory () 
logger . info (questionMaker . removeFirstScienceQuestion () ) 7 
if (players.get (currentPlayer) .getCurrentCategory () 
( 
( 
( 


logger. info (questionMaker . removeFirstSportsQuestion () ) 7 


if (players.get (currentPlayer) .getCurrentCategory() == "Rock") 
logger. info (questionMaker . removeFirstRockQuestion ()); 


} 
// TODO-later: The name of method Game.wasCorrectlyAnswered() should be 
Game .answeredCorrectly () 
public boolean wasCorrectlyAnswered() { 
if (players.get (currentPlayer) .isInPenaltyBox()) { 
nextPlayer (); 
boolean theGameIsStillInProgress = true; 
return theGameIsStillInProgress; 
} 
return currentPlayerGetsAGoldCoinAndSelectNextPlayer (); 
} 
private boolean currentPlayerGetsAGoldCoinAndSelectNextPlayer() { 
logger.info("Answer was correct!!!!"); 
players.get (currentPlayer) .winAGoldCoin () ; 
logger. info (players.get (currentPlayer) 
+" now has " 
+ players.get (currentPlayer) .countGoldCoins () 
+" Gold Coins."); 
boolean isGameStillInProgress = isGameStillInProgress () 7 
nextPlayer (); 
return isGameStillInProgress; 
} 
private void nextPlayer() { 
currentPlayert+; 
if (currentPlayer == players.size()) currentPlayer = 0; 


} 
// TODO-later: The name of method Game.wrongAnswer() should be Game.answeredWrong () 
public boolean wrongAnswer() { 
logger.info("Question was incorrectly answered") ; 
logger.info(players.get (currentPlayer) + " was sent to the penalty box"); 
players .get (currentPlayer) .sentToPenaltyBox () ; 
nextPlayer (); 
boolean theGameIsStillInProgress = true; 
return theGameIsStillInProgress; 


private boolean isGameStillInProgress() { 
return ! (players.get (currentPlayer) .countGoldCoins() == NUMBER_OF_GOLD_ 
COINS_TO_WON_AND GAME OVER) ; 


Player 类 的 代码 如 下 所 示 : 


Public class Player { 
public static final int MAX NUMBER OF PLACE = 12; 


public static final int CATEGORY_POP_I = 0; 
public static final int CATEGORY_POP_2 = 4; 
public static final int CATEGORY POP 3 = 8; 


public static final int CATEGORY_SCIENCE_1 = 
public static final int CATEGORY_SCIENCE_2 
public static final int CATEGORY SCIENCE 3 = 
public static final int CATEGORY SPORTS T 
public static final int CATEGORY_SPORTS 2 
public static final int CATEGORY_SPORTS_3 = 
public static final String POP = "Pop" 
public static final String SCIENCE = 
public static final String SPORTS = "Sports"; 
public static final String ROCK = "Rock"; 
private String playerName; 
private int place = 0; 
private int sumOfGoldCoins = 0; 
private boolean isInPenaltyBox = 
public Player (String playerName) 
this.playerName = playerName; 


false; 
{ 


} 
@Override 
public String toString() { 
return this.playerName; 
} 
public void moveForwardSteps (int steps) { 
this.place += steps; 
if (this.place > MAX NUMBER OF PLACE - 1) this.place -= MAX NUMBER OF PLACE” 
} 
public int getPlace() { 
return this.place; 
} 
public String getCurrentCategory() { 


if (this.place == CATEGORY POP 1) return POP; 

if (this.place CATEGORY POP 2) return POP; 

if (this.place CATEGORY POP 3) return POP; 

if (this.place CATEGORY SCIENCE 1) return SCIENCE; 
if (this.place CATEGORY SCIENCE 2) return SCIENCE; 
if (this.place CATEGORY SCIENCE 3) return SCIENCE; 
if (this.place CATEGORY SPORTS 1) return SPORTS; 
if (this.place == CATEGORY_SPORTS 2) return SPORTS; 


= | 2) 
if (this.place == CATEGORY SPORTS 3) return SPORTS; 
return ROCK; 


} 
public void winAGoldCoin() { 
this.sumOfGoldCoins++; 


public int countGoldCoins() { 
return this.sumOfGoldCoins; 


} 

public boolean isInPenaltyBox() { 
return this.isInPenaltyBox; 

} 

public void getOutOfPenaltyBox () { 
this.isInPenaltyBox = false; 

} 

public void sentToPenaltyBox() { 
this.isInPenaltyBox = true; 

} 


QuestionMaker 类 的 代码 如 下 所 示 : 


public class QuestionMaker { 
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f) 对 于 未 被 使 用 的 方法 ， 可 以 大 胆 删 除 ， 写 好 Commit Message， 等 以 后 需要 时 


9 


public static final int MAX NUMBER OF QUESTIONS = 50; 
private LinkedList<String> popQuestions = new LinkedList<String>() ; 


private LinkedList<String> scienceQuestions = new LinkedList<String>(); 
private LinkedList<String> sportsQuestions = new LinkedList<String>(); 


private LinkedList<String> rockQuestions = new LinkedList<String>(); 
public QuestionMaker() { 
for (int i = 0; i < MAX NUMBER OF QUESTIONS; i++) { 
addPopQuestion (" "Pop | Question 下 + i); 
addScienceQuestion( ("Science Question " + i)); 
addSportsQuestion(("Sports Question " + i)); 
addRockQuestion ("Rock Question " + i); 
} 
public void addPopQuestion (String popQuestion) { 
popQuestions.add(popQuestion) ; 


public void addScienceQuestion (String scienceQuestion) { 
scienceQuestions.add(scienceQuestion) ; 

} 

public void addSportsQuestion (String sportsQuestion) { 
sportsQuestions.add(sportsQuestion) ; 


} 
public void addRockQuestion (String rockQuestion) { 
rockQuestions.add (rockQuestion); 


} 
public String removeFirstPopQuestion() { 
return popQuestions.removeFirst (); 


public String removeFirstScienceQuestion() { 
return scienceQuestions.removeFirst (); 


} 

public String removeFirstSportsQuestion() { 
return sportsQuestions.removeFirst (); 

f 

public String removeFirstRockQuestion() { 
return rockQuestions.removeFirst (); 


} 


) 用 了 提取 出 具有 良好 命名 的 解释 性 的 变量 的 方法 解决 条 件 判断 语句 中 条 件 不 易 读 


消除 了 一 些 魔法 数 。 


为 Player 类 编写 用 户 意图 测试 。 


) 将 不 易 读 的 条 件 判断 或 返回 值 提取 、 命 名 成 易 读 的 解释 性 变量 。 


回 


的 问题 。 


) 当 对 生产 代码 的 行为 理解 不 准时 ， 编 写 出 的 测试 会 运行 失败 ， 此 时 需要 根据 用 户 


) 当 TODO 不 是 很 多 且 手 上 也 没有 正在 处 理 的 任务 时 ， 可 以 一 发 现代 码 “ 腐 臭 ”就 随时 修改 ， 


) 确保 函数 中 的 语句 都 处 于 同一 抽象 层次 上 。 和 否则 就 使 用 提取 方法 的 做 法 ， 来 确保 提 


意图 和 


oO 


fa 


) 可 以 使 用 卫 语句 来 蔡 代 嵌 套 的 条 件 表达 式 。 


h) 将 多 次 使 用 的 字符 串 提取 成 常量 以 增强 可 维护 性 ， 并 能 消除 重复 代码 。 


i) 


j) 当 一 个 大 类 被 分 解 为 多 个 小 类 后 ， 就 可 以 把 原先 分 布 在 大 类 中 各 处 与 小 类 相关 的 逻辑 ， 按 照 小 类 的 职责 转移 到 相 
的 构造 器 中 。 


1) 


唐僧 在 取经 路 上 相继 收 了 悟空 、 八 戒 和 沙 僧 为 徒 后 ， 


将 包含 多 种 用 户 意图 的 大 的 测试 类 分 解 为 只 包含 一 种 用 户 意图 的 小 的 测试 类 。 


) 每 一 次 重 构 都 可 能 让 以 前 运行 通过 的 涡 


当 实 现 新 特性 时 ， 有 时 新 特性 的 用 户 意图 会 与 原 有 特性 的 用 户 意 


网 


保留 下 来 的 成 员 变量 逐步 取代 要 被 替换 的 成 员 变量 ， 最 后 再 清除 后 者 的 定义 的 做 法 ， 来 消除 两 个 成 员 


在 类 的 职责 划分 上 基本 没有 什么 大 问题 的 前 提 下 ， 阅 读 代 码 ， 发 现 遗 留 的 代码 “ 腐 臭 ”并 用 TODO 记 录 下 来 ， 以 便 解 决 。 


服 完了 Trivia 烂 代码 ， 接 下 来 还 要 操练 一 下 用 Mock 来 为 已 有 代码 编写 单元 测试 。 不 过 在 继续 操练 之 前 ， 让 我 们 看 一 看 本 章 都 做 了 哪些 工作 。 


) 在 Player 类 中 ， 清 除了 成 员 变量 isGettingOutOfPenaltyBox， 消 除了 原先 在 islnPenalty-Box 和 isGettingOutOfPenaltyBox 这 两 个 成 员 变 量 


间 存 在 的 逻辑 上 的 重复 。 


不 必 再 写 TODO。 
取出 来 的 每 个 方法 中 的 语句 都 在 同一 个 抽象 


从 版 本 管理 系统 中 找 出 来 也 不 迟 。 


有 冲突 ， 此 时 要 根据 新 特性 的 用 户 意 


图 
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第 34 页 


更 改 原 有 的 测试 代码 ， 


) 用 提取 方法 的 办 法 解决 了 Game 类 的 构造 器 中 语句 不 在 同一 抽象 层次 上 的 问题 
使 用 了 卫 语 句 解决 了 说 套 的 条 件 表 达 式 难以 阅读 的 问题 。 

) 将 GameTest 这 个 包含 全 部 13 个 测试 的 大 类 ， 按 照 测试 彼此 的 相关 性 ， 分 解 出 Player-Test 和 QuestionMakerTest 这 两 个 测试 小 类 。 
实现 了 Trivia 题 目的 新 特性 。 

0) 通过 操练 我 们 学 到 了 以 下 技能 


变量 之 间 在 逻辑 上 的 重复 。 


层次 上 。 


应 的 小 类 中 。 比 如 把 Game 类 的 构造 器 中 的 问题 


试 运行 失败 。 此 时 要 频繁 地 运行 测试 ， 发 现 失败 就 立即 解决 ， 以 缩小 范围 ， 降 低 查找 问题 的 难度 。 


进而 更 改 生产 代码 ， 从 而 实现 新 特性 的 用 户 意图 。 


第 16 章 ”分 而 测 之 一 一 编写 Stub 及 提取 接口 


继续 马不停蹄 地 向 西 赶路 。 黎 山 老母 、 观 音 、 


普 贤 和 文殊 这 4 位 车 萨 觉 


得 应 该 考验 一 下 师 徒 四 


产 代码 的 实际 行为 调整 测试 代码 ， 来 达到 二 者 的 平衡 。 


页 准备 的 语句 转移 到 QuestionMaker 类 


人 组 成 的 这 个 新 团 


队 ， 看 看 他 们 的 禅 心 是 否 清静 。 于 是 


4 位 车 萨 化 作 如 花 似 玉 的 母 女 四 人 ， 组 成 一 个 窒 妇 人 家 ， 住 在 一 个 阔 气 的 大 宅院 里 ， 迎 接 路 过 的 师 徒 四 人 。 在 将 他 们 请 进 屋 中 喝 茶 时 ， 黎 山 老母 化 作 的 母亲 就 开始 向 师 徒 四 人 人 提亲， 希望 唐 僧 做 家 长 ， 并 希望 
将 3 位 女儿 许配 给 3 位 徒弟 ， 尽 享 富贵 。 唐 僧 、 悟 空 和 沙 僧 皆 不 动心 。 唯 有 八 戒 在 见 到 母 女 四 人 后 ， 贪 图 美 色 ， 心 痒 难 挠 ， 甚 至 向 黎 山 老 母 表白 愿 同 时 娶 这 母 女 四 人 为 妻妾 。 最 后 被 黎 山 老母 吊 在 树 上 ， 作 为 
惩戒 。 


这 个 西游 记 的 “四 圣 试 禅 心 ”故事 ， 除 了 表现 唐僧 取经 的 坚定 决心 之 外 ， 还 能 给 我 们 一 点 启示 ， 来 解决 下 面 这 个 在 单元 测试 时 经 常 面临 的 问题 : 如 何 解决 被 测 系统 (System Under Test， 以 下 简称 
SUTI!) 所 依赖 的 组 件 (Depended-On Component， 以 下 简称 DOC) 在 测试 中 难以 控制 的 问题 。 


如 果 把 这 个 故事 看 成 对 师 徒 四 人 的 一 个 测试 ， 那 么 4 位 车 萨 就 好 比 是 测试 工程 师 ， 故 事 本 身 就 好 比 是 测试 代码 (Test Code) ， 师 徒 四 人 好 比 是 SUT， 而 向 师 徒 四 人 提亲 时 所 需要 的 现实 世界 的 4 位 女性 
就 好 比 是 DOC。 这 个 测试 的 时 序 图 如 图 16-1 所 示 。 


Test: 四 圣 试 : 师 徒 四 人 DOC: 四 位 女性 
人 尽心 


图 16-1 安排 师 徒 四 人 与 现实 世界 的 四 位 女性 相亲 的 时 序 


对 于 4 位 车 萨 来 说， 尽管 他 们 法 力 无 边 ， 但 是 要 想 真 的 从 现实 世界 中 找到 4 位 看 起 来 比较 般配 上 且 愿 意 嫁 给 师 徒 四 人 的 女性 ， 并 且 让 她 们 与 师 徒 四 人 碰面 ， 也 是 难于 上 青天 的 。 好 在 4 位 车 萨 可 以 运用 法 
力 ， 根 据 现实 世界 美女 的 接口 ， 来 分 别 化 为 母 女 四 人 ， 住 在 一 个 大 宅院 中 ， 来 等 候 师 徒 四 人 。 这 样 一 来 ， 车 萨 化 作 的 母 女 四 人 就 好 比 Test Double (测试 替身 ) 。 用 车 萨 化 作 的 母 女 四 人 蔡 代 现实 世界 的 4 位 
女性 来 向 师 徒 四 人 提亲 的 时 序 图 如 图 16-2 所 示 。 


Test: 四 圣 试 SUT: 师 徒 四 人 | DOC: 四 位 女性 | Test Double: 


实心 T 车 萨 变 的 母 女 
四 人 


图 16-2 ” 著 萨 在 取经 必 经 之 地 化 作 母 女 四 人 向 师 徒 四 人 提亲 的 时 序 图 


只 要 4 位 车 萨 化 作 的 母 女 四 人 能 够 酷似 现实 世界 的 美女 ， 或 者 用 程序 员 的 话说 ， 只 要 这 母 女 四 人 能 够 实现 现实 世界 美女 的 所 有 接口 ， 那 么 师 徒 四 人 就 可 以 把 这 母 女 四 人 当成 现实 世界 的 美女 来 成 亲 ， 而 车 
萨 们 就 能 利用 这 样 的 机 会 来 考验 师 徒 四 人 。 


“四 圣 试 禅 心 ”的 故事 告诉 我 们 ， 当 SUT 所 依赖 的 DOC 很 难 在 测试 中 进行 控制 时 ， 就 可 以 像 4 位 车 萨 那样 ， 根 据 现实 世界 的 女性 这 个 DOC， 提 取出 美女 这 个 接口 ， 然 后 让 师 徒 四 人 这 个 SUT 不 再 针对 现 
实 世界 的 女性 这 个 DOC， 而 是 针对 美女 这 个 接口 来 做 出 反应 ， 并 根据 这 个 美女 接口 化 作 母 女 四 人 这 样 易 于 控制 的 Test Double 的 做 法 ， 来 蔡 代 难以 控制 的 DOC， 从 而 令 师 徒 四 人 这 个 SUT 把 母 女 四 人 这 个 
Test Double 当 成 美女 接口 来 看 待 ， 进 而 考验 师 徒 四 人 这 个 SUT。 毕 竟 母 女 四 人 这 个 Test Double 就 是 著 萨 变 的 ， 所 以 想 怎样 控制 就 可 怎样 控制 ， 从 而 解决 了 DOC 在 测试 中 难以 控制 的 问题 。 


现在 咱们 就 操练 用 提取 接口 的 方法 来 为 DOC 编 写 Stub。 


“我 没有 编写 过 Stub。 但 我 经 常 听 说 在 编写 单元 测试 时 要 写 Mock。Stub 和 Mock 到 诡 有 什么 区 别 呢 ?“ 


Stub 和 Mock 都 属于 Test Double。Stub 的 作用 是 让 测试 能 够 控制 SUT 的 间接 输入 ， 以 便于 测试 能 够 强制 SUT 进 入 正常 情况 下 很 难 进 入 的 运行 路 径 中 ; 而 Mock 的 作用 是 让 测试 能 够 验证 SUT 的 间接 输 


在 “四 圣 试 禅 心 ”的 故事 中 ，4 位 车 萨 化 作 的 母 女 四 人 就 好 比 Stub， 因 为 这 个 Stub 可 以 作为 向 师 徒 四 人 这 个 SUT 提 亲 的 间接 输入 ， 从 而 强制 师 徒 四 人 考虑 在 正常 情况 下 很 难 有 机 会 考虑 的 成 亲 这 件 事 。 
在 整个 故事 中 ，3 位 女儿 除了 作为 提亲 这 件 事 的 间接 输入 ， 做 一 些 跑 龙套 的 事情 外 ， 并 没有 做 多 少 有 关 判 断 师 徒 四 人 禅 心 的 事情 ， 所 以 3 位 女儿 仅仅 是 Stub。 而 黎 山 老母 化 作 的 母亲 ， 除 了 像 3 位 女儿 一 样 做 
间接 输入 ， 还 下 了 “唐僧 、 悟 空 、 沙 僧 这 3 位 圣 僧 有 德 不 俗 ， 八 戒 无 禅 有 凡 ” 的 判断 ， 这 相当 于 验证 了 SUT 的 间接 输出 ， 所 以 黎 山 老母 化 作 的 母亲 起 到 了 Mock 的 作用 。 


“ 哦 ， 这 下 就 明白 多 了 。” 


咱们 这 个 编写 Stub 的 编程 操练 题目 是 Tire Pressure Monitoring System[]。 这 个 题目 是 有 关 轮 胎 气压 检测 系统 的 。 有 两 个 类 Alarm 和 Sensor， 其 中 Sensor 类 负责 获取 胎 压 值 ， 而 Alarm 类 则 检查 
Sensor 传 来 的 胎 压 值 ， 若 在 正常 范围 之 外 则 报警 。 另 外 ， 当 前 后 两 次 检查 胎 压 值 时 ， 若 前 一 次 检查 的 胎 压 值 在 正常 范围 之 外 并 报警 后 ， 后 一 次 检查 的 胎 压 值 又 回 到 正常 范围 ， 此 时 应 该 继续 报警 ， 以 便于 
工 干预 。 本 操练 要 求 首 先 为 Alarm 类 编写 单元 测试 ， 然 后 在 测试 的 保护 下 实现 一 个 新 功能 : 在 前 后 两 次 检查 胎 压 值 时 ， 若 前 一 次 检查 的 胎 压 值 在 正常 范围 之 外 并 报警 ， 后 一 次 检查 的 胎 压 值 又 回 到 正常 范 
围 ， 此 时 应 该 停止 报警 。 


人 


“ 先 看 一 看 源 代码 Bl 中。 


源 代码 只 有 3 个 类 。 其 中 ， 第 1 个 类 Sensor 有 一 个 名 为 popNextPressurePsiValue () 的 公共 接口 ， 来 返回 一 个 由 随机 数 产生 的 胎 压 值 。 


Sensor 类 的 代码 如 下 所 示 : 


public class Sensor { 
public static final double OFFSET = 16; 
public double popNextPressurePsiValue () 


double pressureTelemetryValue; 
pressureTelemetryValue = samplePressure (); 
return OFFSET + pressureTelemetryValue; 


private static double samplePressure () 


// placeholder implementation that simulate a real sensor in a real tire 

Random basicRandomNumbersGenerator = new Random (42) ; 

double pressureTelemetryValue = 6 * basicRandomNumbersGenerator.nextDouble() * 
basicRandomNumbersGenerator.nextDouble () ; 

return pressureTelemetryValue; 


} 


第 2 个 类 Alarm 有 两 个 公共 接口 ， 一 个 名 为 check () ， 用 来 调用 Sensor 的 popNext-PressurePsiValue () 方法 来 获取 胎 压 值 ， 并 判断 胎 压 值 是 否 在 正常 范 四 
alarmOn 这 个 私有 成 员 变 量 赋值 为 true， 即 设置 为 报警 状态 。 另 一 个 公共 接口 名 为 isAlarmOn () ， 仅 仅 是 返回 alarmOn 这 个 成 员 变 量 的 值 。 


内 ， 若 不 在 正常 范围 内 ， 则 将 该 类 的 


是 


Alarm 类 的 代码 如 下 所 示 : 


public class Alarm { 
private final double LowPressureThreshold = 17; 
private final double HighPressureThreshold = 21; 
private Sensor sensor = new Sensor(); 
private boolean alarmOn = false; 
public void check () 
{ 
double psiPressureValue = sensor.popNextPressurePsiValue () ; 
if (psiPressureValue < LowPressureThreshold || HighPressureThreshold < 
psiPressureValue) 
{ 
alarmOn = true; 
} 
} 
public boolean isAlarmOn () 
{ 


return alarmOn; 


} 


第 3 个 类 AlarmTest 是 一 个 测试 类 ， 里 面 只 有 一 个 测试 2+3=5 的 这 个 必然 通过 的 测试 ， 用 来 验证 单元 测试 框架 JUnit 是 否 能 正常 工作 。 把 光标 移动 到 这 个 测试 类 名 上 ， 然 后 按 Ctrl+ Shift+F10 组 合 键 ， 运 
行 一 下 这 个 测试 。 通 过 。 


“代码 很 易 读 ， 看 起 来 也 不 那么 烂 呀 .“ 


代码 虽然 易 读 ， 但 由 于 没有 测试 保护 ， 使 其 对 于 代码 维护 者 来 说 反馈 慢 ， 所 以 还 是 属于 烂 代码 。 


这 个 操练 题目 要 求实 现 一 个 新 功能 : 若 前 一 次 检查 的 胎 压 值 在 正常 范围 之 外 并 报警 ， 后 一 次 检查 的 胎 压 值 又 回 到 正常 范围 ， 此 时 应 该 停止 报警 。 能 否 把 这 个 新 特性 写 一 个 TODO 呢 ? 


“我 刚才 读 了 代码 。 要 实现 这 个 功能 ， 只 要 Alarm 类 的 check () 方法 每 次 检查 胎 压 值 之 前 ， 把 警报 关闭 就 好 了 ， 也 就 是 把 alarmOn 赋 值 为 false 就 可 以 了 。” 


添加 新 特性 在 每 次 检查 胎 压 前 将 警报 关闭 的 TODO 的 代码 如 下 所 示 (CM: Added TODO-new-feature: the alarm will be turned off before each checking of pressure.) : 


public class AlarmTest { 


+ // TODO-new-feature: the alarm will be turned off before each checking of pressure 


} 
我 感觉 这 个 TODO 写 得 有 些 问题 。 


“什么 问题 ?“ 


如 果 用 TDD 来 实现 这 个 新 特性 的 TODO， 那 么 就 需要 先 写 测试 ， 然 后 用 测试 中 的 意图 代码 来 驱动 生成 生产 代码 。 换 名 话说， 咱们 的 测试 将 来 就 要 针对 这 个 TODO 来 写 。 而 这 个 TODO 是 在 每 次 检查 胎 压 
前 将 警报 关闭 ， 这 是 具体 实现 。 前 面 咱们 讨论 过 ， 针 对 具体 实现 的 测试 代码 注定 是 脆弱 的 ， 因 为 这 违反 了 依赖 倒置 原则 。 


“ 哦 ， 对 。 确 实 这 个 TODO 是 依赖 具体 实现 了 。 需 要 把 这 个 TODO 从 抽象 的 用 户 意图 的 角度 出 发 来 改 一 改 。” 


将 针对 具体 实现 的 在 每 次 检查 胎 压 前 将 警报 关闭 的 新 特性 TODO， 改 为 针对 抽象 的 用 户 意图 的 “跟随 在 正常 范围 之 外 的 胎 压 值 之 后 的 正常 胎 压 值 应 该 能 让 之 前 所 引发 的 警报 停止 ”的 代码 如 下 所 示 


(CM: Updated the new feature TODO to be of user intent: a normal pressure value after a value outside the range should stop the alarm.) : 


public class AlarmTest { 


= // TODO-new-feature: the alarm will be turned off before each checking of pressure 
ae // TODO-new-feature: a normal pressure value after a value outside the 
range should stop the alarm 


} 


写 完了 新 特性 的 TODO， 现 在 可 以 大 概 读 一 读 这 些 代码 ， 看 看 能 否 看 到 比较 严重 的 问题 。 


“开始 我 还 以 为 这 些 代码 写 得 很 烂 呢 ， 但 读 完 之 后 发 现 写 得 还 算 比 较 整洁 ， 没 有 发 现 什 么 很 严重 的 问题 。” 


这 个 题目 中 的 两 个 类 Alarm 和 Sensor， 是 谁 依赖 谁 ? 
“Alarm 类 依赖 Sensor 类 。 ” 
对 。 那 么 Alarm 类 是 如 何 依赖 Sensor 类 的 ? 


“在 Alarm 类 中 new 出 了 一 个 Sensor 对 象 。” 


问题 就 出 在 new 这 个 操作 符 上 了 。 通 过 new 操 作 符 创建 的 Sensor 对 象 ， 就 让 Alarm 类 依赖 一 个 具体 的 Sensor 对 象 ， 而 不 是 一 个 抽象 。 这 样 做 就 会 违反 前 面 提 到 的 依赖 倒置 原则 。 另 外 由 于 Alarm 类 依赖 
的 是 new 出 来 的 Sensor 类 的 具体 的 实现 ， 这 样 就 无 法 用 扩展 的 方法 将 其 替换 为 一 个 测试 替身 来 进行 单元 测试 ， 无 法 做 到 “对 修改 关闭 ， 对 扩展 开放 ”， 所 以 也 违反 了 开 闭 原则 。 


“但 是 Alarm 类 确实 需要 一 个 具体 的 Sensor 对 象 来 帮 它 获得 胎 压 值 呀 。 如 何 才能 做 到 即 能 让 Alarm 类 依赖 一 个 抽象 ， 又 能 让 Alarm 类 获得 一 个 具体 的 Sensor 对 象 呢 ?” 


咱们 可 以 把 上 面 提 到 的 那 条 new 出 一 个 具体 Sensor 对 象 的 语句 移动 到 Alarm 类 之 外 ， 并 通过 Alarm 类 的 构造 器 或 setter () 方法 ， 把 这 个 在 外 面 new 出 的 具体 的 Sensor 对 象 注 入 Alarm 对 象 中 ， 而 Alarm 
类 的 构造 器 或 setter () 方法 则 带 有 从 Sensor 类 所 提取 的 接口 的 类 型 。 这 样 就 可 以 做 到 上 面 那 一 点 。 一 会 通过 写意 图 代码 就 能 看 得 明白 。 先 把 这 个 问题 用 TODO 记 下 来 。 


在 Alarm 类 中 添加 有 关 “new Sensor () ; ”语句 违反 依赖 倒置 和 开 闭 原则 的 TODO 的 代码 如 下 所 示 (CM: Added TODO: Depending on a concrete Sensor violates the Dependency Inversion 
Principle and Open-Closed Principle.) : 


public class Alarm { 


+ // TODO: Depending on a concrete Sensor violates the Dependency Inversion 
Principle and Open-Closed Principle 
private Sensor sensor = new Sensor (); 


写 完 了 这 个 依赖 具体 实现 的 TODO， 接 下 来 可 以 看 看 该 写 哪些 有 关 测 试 的 TODO 了 。 


“需要 针对 用 户 意图 来 编写 有 关 测 试 的 TODO。 从 用 户 角度 出 发 ， 我 现在 能 想到 的 用 户 意图 有 3 个 。 第 一 个 是 检测 到 正常 的 胎 压 值 时 不 应 该 报警 ; 第 二 个 是 检测 到 正常 范围 之 外 的 胎 压 值 时 应 该 报警 ; 第 
三 个 是 跟随 在 正常 范围 之 外 的 胎 压 值 之 后 的 正常 胎 压 值 应 该 不 会 让 之 前 所 引发 的 警报 停止 。” 


在 AlarmTest 类 中 添加 3 个 有 关 用 户 意图 的 TODO 的 代码 如 下 所 示 (CM: Added 3 user intent test TODOs.) : 


public class AlarmTest { 


+ // TODO-user-intent-test: a normal pressure value should not raise the alarm 
+ // TODO-user-intent-test: a pressure value outside the range should raise the alarm 
+ // TODO-user-intent-test: a normal pressure value after a value outside the 


range should not stop the alarm 
+ 
// TODO-new-feature: a normal pressure value after a value outside the range 
should stop the alarm 


现在 可 以 按 Alt+ 6 快捷 键 来 列 出 所 有 的 5 个 TODO， 挑 一 个 最 简单 的 先 做 。 比 方 说 可 以 先 做 a normal pressure value should not raise the alarm (检测 到 正常 的 胎 压 值 时 不 应 该 报警 ) 这 个 TODO。 
接 把 这 个 TODO 的 英文 单词 之 间 加 上 下 划 线 ， 就 成 了 针对 这 个 TODO 的 测试 的 方法 名 。 这 样 能 使 测试 的 命名 尽量 做 到 像 自 然 语言 那样 容易 阅读 ， 使 得 测试 能 起 到 文档 的 作用 。 另 外 按照 咱们 的 老 习 惯 ， 先 写 
测试 的 Assert 部 分 。 


把 检测 到 正常 的 胎 压 值 时 不 应 该 报警 这 个 TODO 标 记 为 working-on， 并 编写 相应 的 测试 和 其 Assert 部 分 的 代码 如 下 所 示 (CM: Working on TODO: a normal pressure value should not raise the 


alarm.Wrote a test a_normal_pressure value should not raise the alarm () with an Assert part.) : 


public class AlarmTest { 
7 // TODO-user-intent-test: a normal pressure value should not raise the alarm 


+ // TODO-user-intent-test-working-on: a normal pressure value should not 
raise the alarm 
@Test 
+ public void a normal pressure value should not raise the_alarm() { 
+ // Assert 
+ assertFalse (alarm. isAlarmOn () ); 


} 


Assert 部 分 写 好 后 ， 就 可 以 从 它 推出 Act 部 分 。 要 让 alarm.isAlarmOn () 能 获得 正确 的 值 ， 需 要 先 调用 alarm.check () 方法 ， 而 调用 alarm.check () 方法 就 是 测试 的 Act 部 分 。 


4@5a_normal_pressure_value_should_not_raise_the_alarm () 测试 方法 的 Act 部 分 的 代码 如 下 所 示 (CM: Wrote the intention code for the Act and Arrange parts of the test 


a_normal_pressure_value_should_not_raise the alarm () .) : 


public class AlarmTest { 


// TODO-user-intent-test-working-on: a normal pressure value should not 
raise the alarm 


@Test 
public void a normal pressure value_should not raise the alarm() { 
+ //Act P Sa wa 
$ alarm.check (); 
+ 
// Assert 


assertFalse (alarm. isAlarmOn () ); 


写 好 了 Act 部 分 ， 那 么 该 看 alarm 这 个 变量 是 怎么 来 的 了 。alarm 需 要 新 创建 一 个 Alarm 对 象 而 被 new 出 来 。 


在 a_normal_pressure value_should_not raise the_alarm () 测试 方法 的 Arrange 部 分 中 new 出 一 个 Alarm 对 象 的 代码 如 下 所 示 :: 


public class AlarmTest { 


// TODO-user-intent-test-working-on: a normal pressure value should not 
raise the alarm 
@Test 
public void a normal pressure value should not raise the _alarm() { 
+ // Arrange 7 T 7: te 
+ Alarm alarm = new Alarm(); 
+ 
// Bot 
alarm. check () ; 
// Assert 
assertFalse (alarm. isAlarmOn () ); 


“按理 说 ， 这 个 测试 代码 就 能 运行 了 。 运 行 一 下 试 试 ….. 通 过 。 不 过 咱们 读 了 代码 就 能 知道 ， 这 个 测试 运行 的 结果 并 不 总 是 通过 的 ， 因 为 Sensor 类 所 返回 的 下 一 个 胎 压 值 是 一 个 随机 数 ， 不 好 控制 。” 


这 里 ，AlarmTest 类 就 是 测试 代码 ，Alarm 类 就 是 SUT，Alarm 类 所 依赖 的 Sensor 类 就 是 DOC。 就 如 同 难以 在 现实 世界 中 找到 4 位 般配 的 女性 愿意 与 师 徒 四 人 成 亲 一 样 ， 我 们 也 难以 控制 Sensor 这 个 依赖 
于 随机 数 的 类 ， 来 让 它 总 能 返回 我 们 所 期 望 的 某 一 个 胎 压 值 ， 作 为 Alarm 类 的 间接 输入 。 


“在 这 个 例子 中 ， 我 们 需要 根据 Sensor 类 这 个 DOC， 提 取出 一 个 类 似 于 “美女 ”这 样 的 接口 ， 比 如 叫 lsensor， 并 让 SUT 针 对 这 个 接口 编程 ， 从 而 解决 这 个 问题 。” 


思路 很 好 ， 不 过 |Sensor 这 个 接口 命名 不 够 好 。 


“为 什么 不 好 ? 这 样 不 是 很 方便 吗 ? 而 且 C# 语 言 的 命名 惯例 也 是 这 样 的 。” 


有 些 惯例 其 实 是 有 问题 的 。 在 一 个 类 名 前 冠 以 大 写字 面 | 来 命名 一 个 接口 ， 看 似 方便 ， 但 是 将 来 若 把 接口 重 构 为 抽象 类 或 类 时 ， 那 这 个 | 就 词 不 达意 了 。 所 以 最 好 还 是 用 另 一 个 英文 单词 作为 接口 名 。 我 有 
一 个 窍门 。 可 以 用 查找 英文 近义词 的 方法 ， 来 为 一 个 具体 的 类 寻找 它 的 接口 的 命名 。 咱 们 可 以 用 浏览 器 访问 http://translate.google.cn 链 接 ， 然 后 在 左 侧 文 本 框 中 输入 一 个 英文 词 ， 这 样 在 右边 下 方 就 能 看 
到 这 个 词 的 近义词 ， 从 中 选 一 个 就 好 了 。 用 这 个 方法 ， 咱 们 找到 了 Sensor 的 近义词 Transducer。 这 样 可 以 用 Transducer 作 为 接口 的 名 字 。 


浏览 器 访问 http://translate.google.cn 链 接 ， 查 找 英文 近义词 来 用 于 接口 命名 的 界面 如 图 16-3 所 示 。 
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16-3. 用 浏览 器 访问 http:/Vtranslate.google.cn 链 接 查 找 英文 近义词 的 界面 


如 果 有 了 Transducer 这 样 的 接口 ， 就 可 以 根据 这 个 接口 ， 编 写 出 一 个 易于 控制 的 stub 类， 不 妨 命名 为 StubSensor， 来 取代 难以 控制 的 Sensor 类 ， 从 而 令 Alarm 类 把 这 个 StubSensor 类 当成 Transducer 
接口 来 看 待 ， 进 而 方便 地 测试 Alarm 类 。 


“那么 怎样 才能 让 Alarm 类 把 StubSensor 类 当成 Transducer 接 口 来 看 待 呢 ?“ 


可 以 让 Alarm 类 针对 抽象 的 Transducer 接 口 ， 而 不 是 针对 具体 的 Sensor 类 来 编程 。 有 具体 的 想法 是 : 先 从 Sensor 类 中 提取 Transducer 接 口 ， 然 后 让 StubSensor 类 实现 该 接口 ， 并 通过 Alarm 类 的 带 有 
Transducer 类 型 的 构造 器 ， 将 一 个 stubsensor 对 象 注入 Alarm 对 象 中 ， 从 而 让 Alarm 类 把 Stubsensor 类 当成 Transducer 接 口 来 看 待 。 咱 们 可 以 使 用 这 个 编程 意图 ， 在 测试 中 编写 意图 代码 。 先 让 形 参 为 
Transducer 的 Alarm 类 的 构造 器 接受 stubSensor 这 个 实 参 类 型 为 StubSensor 的 参数 。 


让 形 参 为 Transducer 的 Alarm 类 的 构造 器 接受 stubSensor 这 个 实 参 类 型 为 StubSensor 的 参数 的 意图 代码 如 下 所 示 : 


public class AlarmTest { 


// TODO-user-intent-test-working-on: a normal pressure value should not 
raise the alarm 
@Test 
public void a normal pressure value should not raise the alarm() { 
// Arrange 
一 Alarm alarm = new Alarm(); 
+ Alarm alarm = new Alarm(stubSensor) ; 
// Bot 
alarm.check (); 
// Assert 
assertFalse (alarm. isAlarmOn ()); 


引入 这 个 stubSensor 的 目的 是 为 了 便于 在 测试 中 进行 控制 。 比 方 说 ， 在 这 个 测试 中 ， 当 Alarm 对 象 要 取 下 一 个 胎 压 值 时 ， 我 们 会 要 求 stubSensor 总 是 返回 一 个 正常 的 胎 压 值 。 所 以 可 以 让 StubSensor 
类 拥有 一 个 以 给 定 胎 压 值 作为 参数 的 arrangeNextPressurePsiValue () 方法 ， 让 该 类 总 是 能 够 返回 这 个 给 定 的 胎 压 值 。 因 为 胎 压 正常 范围 的 两 个 边界 立 值 也 属于 正常 值 ， 所 以 可 以 要 求 让 stubSensor 总 是 
返回 最 低 的 边界 胎 压 值 。 看 了 一 眼 Alarm 类 的 代码 ， 发 现 这 个 最 低 的 边界 值 是 17， 并 用 一 个 私有 的 常量 成 员 变 量 LowPressureThreshold 来 保存 。 要 是 在 测试 中 直接 写 17 这 样 的 魔法 数 ， 肯 定 是 不 可 取 的 。 
而 最 低 边界 胎 压 值 的 本 质 应 该 是 一 个 全 局 的 常量 。 所 以 可 以 使 用 java 语言 命名 全 局 常量 的 惯例 来 把 这 个 最 低 边界 胎 压 值 命 名 为 Alarm.LOW_PRESSURE_THRESHOLD。 


回 


回 


的 意图 代码 如 下 所 示 : 


让 stubSensor 对 象 通过 调用 arrangeNextPressurePsiValue () 方法 来 把 最 低 边 界 胎 压 值 作为 下 一 个 胎 压 值 返 | 


D 


public class AlarmTest { 


// TODO-user-intent-test-working-on: a normal pressure value should not 
raise the alarm 

@Test 

public void a normal pressure value should not raise the alarm() { 
// Arrange 

+. stubSensor .arrangeNextPressurePsiValue (Alarm. LOW PRESSURE THRESHOLD); 

Alarm alarm = new Alarm(stubSensor) ; ~ n 
// Act 
alarm.check() 7 
// Assert 
assertFalse (alarm.isAlarmOn () ); 


“这 个 stubSsensor 对 象 是 怎么 来 的 ”需要 new 出 一 个 StubSensor 对 象 来 。” 


创建 StubSensor 对 象 的 代码 如 下 所 示 : 


public class AlarmTest { 


// TODO-user-intent-test-working-on: a normal pressure value should not 
raise the alarm 


@Test 
public void a normal pressure value should not raise the alarm() { 
// Arrange 
+ StubSensor stubSensor = new StubSensor (); 


stubSensor .arrangeNextPressurePsiValue (Alarm. LOW_PRESSURE_THRESHOLD) ; 
Alarm alarm = new Alarm(stubSensor) ; 

// Bot 

alarm.check (); 

// Assert 

assertFalse (alarm.isAlarmOn () ) ; 


[ 


代码 所 显示 的 红色 的 编译 错误 的 指引 ， 来 逐个 修复 这 些 错误 。 因 为 StubSensor 类 还 未 创建 ， 所 以 是 红色 的 ， 先 修 


“ 写 好 了 测试 的 意图 代码 ， 仔 细 看 看 没有 什么 问题 后 ， 就 可 以 根据 在 IDEA 中 这 些 意 


创建 StubSensor 类 来 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Created class StubSensor.) : 


+public class StubSensor { 
+} 


“下 一 步 修复 Alarm.LOW_PRESSURE_THRESHOLD 红 色 的 编译 错误 。” 


创建 Alarm.LOW _PRESSURE_ THRESHOLD 类 常量 并 用 其 替换 原 有 私有 常量 的 代码 如 下 所 示 (CM: Fixed compiler error: Created constant field Alarm.LOW_PRESSURE_THRESHOLD and 


replaced it with the original private field.) : 


public class Alarm { 

= private final double LowPressureThreshold = 17; 

出 public static final double LOW_PRESSURE_THRESHOLD = 17; 
private final double HighPressureThreshold = 21; 


= if (psiPressureValue < LowPressureThreshold || HighPressureThreshold < 
psiPressureValue) 

站 if (psiPressureValue < LOW_PRESSURE_THRESHOLD || HighPressureThreshold < 
psiPressureValue) 


{ 


alarmOn = true; 


“下 一 步 修复 调用 stubSensor 对 象 的 arrangeNextPressurePsiValue () 方法 的 红色 编译 错误 。 ” 


创建 StubSensor.arrangeNextPressurePsiValue () 方法 来 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Created method StubSensor.arrangeNextPressurePsiValue () .) : 


public class StubSensor { 
+ public void arrangeNextPressurePsiValue (double nextPressurePsiValue) { 


4 
机 
} 


} 


“ 接 下 来 该 修复 创建 Alarm 对 象 时 向 构造 器 传 入 的 实 参 stubSsensor 的 红色 编译 错误 了 。 不 过 要 修复 这 个 错误 ， 需 要 经 过 多 步 才能 完成 。 首 先 可 以 创建 Alarm 类 的 带 有 Transducer 类 型 参数 的 构造 器 。” 


创建 Alarm 类 的 带 有 Transducer 类 型 参数 的 构造 器 来 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixing compiler error: Created constructor Alarm (Transducer) .) : 


public class Alarm { 


二 public Alarm(Transducer transducer) { 
+ 
+ } 


“Transducer 由 于 还 未 创建 ， 所 以 是 红色 的 ， 再 修复 它 。” 


创建 接口 Transducer 来 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixing compiler error in test: Created interface Transducer.) : 


+public interface Transducer { 
+} 


“由 于 新 创建 的 带 有 参数 的 Alarm 类 的 构造 器 的 形 参 是 接口 Transducer， 而 传 给 这 个 构造 器 的 实 参 是 StubSensor 类 型 的 对 象 ， 且 Stubsensor 类 尚未 实现 Transducer 接 口 ， 所 以 有 这 个 编译 错误 。 现 在 


让 StubSensor 类 实现 Transducer 接 口 ， 来 修复 错误 。” 


让 StubSensor 类 实现 Transducer 接 口 来 修复 错误 的 代码 如 下 所 示 (CM: Fixed compiler error in test: Made class StubSensor implement interface Transducer.) : 


-public class StubSensor { 
+public class StubSensor implements Transducer { 


现在 测试 里 面 的 编译 错误 都 修复 了 。 运 行 测试 ， 通 过 。 但 是 咱们 在 前 面 创建 的 所 有 类 、 接 口 和 方法 里 面 的 内 容 都 是 空 的 ， 所 以 这 个 运行 通过 的 测试 ， 还 是 运行 在 原 有 随机 数 代 码 逻辑 上 的 碰巧 的 运行 通 


过 。 这 个 测试 TODO 尚 未 完成 。 接 下 来 就 要 把 原 有 的 代码 逻辑 切换 到 新 的 逻辑 之 上 ， 即 要 修复 那个 依赖 于 具体 的 Sensor 从 而 违反 依赖 倒置 和 开 闭 原则 的 TODO。 把 它 标记 为 working-on。 


“咱们 在 前 面 创建 了 一 个 带 有 Transducer 类 型 参数 的 Alarm 类 的 构造 器 ， 这 就 要 求 咱们 还 必须 创建 Alarm 类 的 默认 构造 器 ， 以 保持 原 有 接口 。 这 需要 写 一 个 TODO 记 下 来 。” 


在 Alarm 类 中 添加 有 关 创 建 Alarm 类 的 默认 构造 器 以 保持 原 有 接口 的 TODO 的 代码 如 下 所 示 (CM: Added TODO: Retain the original interface for the default constructor of Alarm.) : 


public class Alarm { 


+ // TODO: Retain the original interface for the default constructor of Alarm 
public Alarm(Transducer transducer) { 


“这 个 TODO 比 较 简单 ， 所 以 可 以 先 完成 它 。” 


完成 在 Alarm 类 中 添加 有 关 创 建 Alarm 类 的 默认 构造 器 以 保持 原 有 接口 的 TODO 的 代码 如 下 所 示 (CM: Finished TODO: Retain the original interface for the default constructor of Alarm.) : 


public class Alarm { 


= // TODO-working-on: Retain the original interface for the default constructor 


of Alarm 
oi public Alarm() { 
+ this.sensor = new Sensor (); 


+ } 


“现在 可 以 回 过 头 来 解决 那个 依赖 于 Sensor 具 体 实 现 的 TODO 了 。 可 以 先 在 Alarm 类 中 编写 意图 代码 。 首 先 把 私有 成 员 变量 sensor 改 名 为 transducer， 并 且 将 其 类 型 换 成 Transducer。 另 外 把 


Sensor () ; ”这 句 话 放 到 Alarm 类 的 默认 构造 器 中 。 再 把 所 有 原先 引用 成 员 变 量 sensor 的 地 方 换 成 transducer。 最 后 在 新 增 的 Alarm 类 的 带 有 Transducer 类 型 的 构造 器 中 ， 将 传 入 的 实 参 transducer 保 存 


在 该 类 的 transducer 的 成 员 变 量 中 。” 


‘new 


在 Alarm 类 中 编写 意图 代码 来 解决 那个 依赖 于 Sensor 具 体 实现 的 TODO 的 代码 如 下 所 示 (CM: Wrote intention code for TODO: Depending on a concrete Sensor violates the Dependency 


[ 


Inversion Principle and Open-Closed Principle.) : 


public class Alarm { 


// TODO-working-on: Depending on a concrete Sensor violates the Dependency 
Inversion Principle and Open-Closed Principle 
= private Sensor sensor = new Sensor (); 
+ private Transducer transducer = null; 
private boolean alarmOn = false; 
public Alarm() { 
this.sensor = new Sensor (); 
+ this.transducer = new Sensor (); 


public Alarm(Transducer transducer) { 
+ this.transducer = transducer; 

} 

public void check () 

{ 


= double psiPressureValue 
+ double psiPressureValue 


sensor .popNextPressurePsiValue (); 
transducer .popNextPressurePsiValue () ; 


“这 段 意图 代码 写 完 后 ， 就 在 Alarm 类 中 出 现 了 两 处 红色 的 编译 错误 。 先 修复 出 现在 Alarm 类 默认 构造 器 中 的 那 一 行 “this.transducer = new Sensor () ; ”语句 的 编译 错误 。 这 处 错误 的 原 


DH 


Sensor 类 尚未 实现 Transducer 接 口 。 现 在 就 修复 它 。” 


让 Sensor 类 实现 Transducer 接 口 来 修复 编程 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Made class Sensor implement interface Transducer.) : 


-Public class Sensor { 
+public class Sensor implements Transducer { 


“下 一 个 有 红色 编译 错误 的 地 方 是 调用 transducer 对 象 的 popNextPressurePsiValue () 方法 ,错误 的 原因 是 Transducer 接 口 还 没有 定义 这 个 方法 ， 现 在 就 修复 它 。” 


在 接口 Transducer 中 添加 popNextPressurePsiValue () 方法 的 定义 来 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Created method 


Transducer.popNextPressurePsiValue () .) : 


public interface Transducer { 
+ double popNextPressurePsiValue () 7 
} 


“现在 Alarm 类 中 所 有 红色 的 编译 错误 都 修复 了 。 可 以 按 Ctrl+F5 快 捷 键 重新 运行 测试 。 出 现 另 一 个 编译 错误 : StubSensor 类 尚未 实现 刚刚 在 其 所 实现 的 接口 Transducer 中 新 增 的 方法 


popNextPressurePsiValue () 。 现 在 就 修复 它 。 先 在 StubSensor 类 中 创建 一 个 带 有 @Override 标 注 的 popNextPressurePsiValue () 方法 ， 然 后 让 它 返 回 该 类 在 成 员 变量 nextPressurePsiValue 中 所 保 
存 的 下 一 个 胎 压 值 。 而 成 员 变量 nextPressurePsiValue 中 所 保存 的 下 一 个 胎 压 值 又 来 自 该 类 的 方法 arrangeNextPressurePsiValue () 所 传 入 的 参数 ， 即 我 们 通过 Stub 来 进行 控制 的 期 望 的 胎 压 值 。 


在 StubSensor 类 中 实现 popNextPressurePsiValue () 方法 的 代码 如 下 所 示 (CM: Fixed compiler error: Implemented method StubSensor.popNextPressurePsiValue () .) : 


Public class StubSensor implements Transducer { 
private double nextPressurePsiValue; 


++ 


public void arrangeNextPressurePsiValue (double nextPressurePsiValue) { 
this.nextPressurePsiValue = nextPressurePsiValue; 

} 

@Override 

public double popNextPressurePsiValue() { 
return this.nextPressurePsiValue; 


十 十 十 十 十 


“运行 测试 ， 通 过 。 既 然 StubSsensor 类 实现 Transducer 接 口 时 写 了 @Override 标 注 ， 那 么 Sensor 类 实现 Transducer 接 口 时 也 应 该 写 这 个 标注 。” 


在 Sensor 类 的 popNextPressurePsiValue () 方法 前 面 添 加 @Override 标 注 的 代码 如 下 所 示 (CM: Added Override notation to method Sensor.popNextPressurePsiValue () .) : 


public class Sensor implements Transducer { 


+ @Override 
public double popNextPressurePsiValue () 


“运行 测试 ， 通 过 。 现 在 既 完成 了 那个 依赖 于 Sensor 具 体 实 现 的 TODO， 又 完成 了 检测 到 正常 的 胎 压 值 时 不 应 报警 的 用 户 意图 TODO。 可 以 把 这 两 个 TODO 删 除了 。” 


接 下 来 该 处 理 下 一 个 用 户 意图 的 测试 TODO 了 : 检测 到 正常 范围 之 外 的 胎 压 值 时 应 该 报警 。 这 个 TODO 的 测试 的 意图 代码 与 前 一 个 有 关 检 测 到 正常 范 
很 相似 。 只 不 过 arrangeNextPressurePsiValue () 方法 传 入 的 是 Alarm.HIGH_PRESSURE THRESHOLD+1 这 个 正常 范 


之 内 的 胎 压 值 不 应 报警 的 用 户 意图 的 测试 TODO 
之 外 的 值 。 另 外 最 后 判断 alarm.isAlarmOn () 用 的 是 assertTrue () 。 


[ 
at 
[ 


将 用 户 意图 的 测试 TODO “检测 到 正常 范围 之 外 的 胎 压 值 时 应 该 报警 ”标记 为 working-on， 并 编写 相关 测试 的 意图 代码 的 代码 如 下 所 示 (CM: Working on TODO: a pressure value outside the 


range should raise the alarm.Wrote intention code for the Assert, Act and Arrange parts of the test a_pressure value outside the range should raise the alarm () .) : 


[ 
区 


public class AlarmTest { 


Fay // TODO-user-intent-test: a pressure value outside the range should raise the alarm 


+ // TODO-user-intent-test-working-on: a pressure value outside the range 
should raise the alarm 

+ @Test 

+ public void a pressure value outside the range should raise the alarm() { 

+ // Arrange 

$ StubSensor stubSensor = new StubSensor (); 

+. stubSensor.arrangeNextPressurePsiValue (Alarm.HIGH PRESSURE THRESHOLD + 1); 

+ Alarm alarm = new Alarm(stubSensor) ; z E 

+ 

+ // Bot 

本 alarm.check (); 

+ 

+ // Assert 

+ assertTrue (alarm.isAlarmOn () ); 

+ } 


豆 
fea 
a 
|li 


代码 写 好 后 ， 出 现 了 一 处 红色 的 编译 错误 : HIGH PRESSURE THRESHOLD。 这 是 因为 Alarm 类 尚未 定义 这 个 常量 。 现 在 就 修复 这 个 错误 。” 


创建 Alarm.HIGH_PRESSURE_ THRESHOLD 类 常量 并 用 其 替换 原 有 私有 常量 的 代码 如 下 所 示 (CM: Fixed compiler error: Created constant field Alarm.HIGH_PRESSURE_THRESHOLD and 


replaced it with the original private field.) : 


public class Alarm { 
public static final double LOW_PRESSURE_THRESHOLD = 17; 
= private final double HighPressureThreshold = 21; 
中 public static final double HIGH_PRESSURE_THRESHOLD = 21; 
private Transducer transducer = null; 


= if (psiPressureValue < LOW_PRESSURE_THRESHOLD || HighPressureThreshold < 
psiPressureValue) 
+. if (psiPressureValue < LOW PRESSURE THRESHOLD || HIGH _ PRESSURE THRESHOLD < 
psiPressureValue) 
{ 
alarmOn = true; 


} 


m=z; 


运行 测试 ， 通 过 。 现 在 完成 了 “检测 到 正常 范围 之 外 的 胎 压 值 时 应 该 报警 ”的 测试 意图 TODO， 可 以 将 其 删除 。” 


现在 该 处 理 “ 跟 随 在 正常 范围 之 外 的 胎 压 值 之 后 的 正常 胎 压 值 应 该 不 会 让 之 前 所 引发 的 警报 停止 ”这 个 TODO 了 。 


将 “跟随 在 正常 范围 之 外 的 胎 压 值 之 后 的 正常 胎 压 值 应 该 不 会 让 之 前 所 引发 的 警报 停止 ”这 个 TODO 标 记 为 working-on， 并 编写 相应 测试 的 Assert 部 分 的 代码 如 下 所 示 (CM: Working on TODO: a 
normal pressure value after a value outside the range should not stop the alarm.Wrote the Assert part of the test 


a_normal_pressure_value_after_a value outside the range should not stop the alarm () .) : 


public class AlarmTest { 


> // TODO-user-intent-test: a normal pressure value after a value outside the 
range should not stop the alarm 


+ // TODO-user-intent-test-working-on: a normal pressure value after a value 
outside the range should not stop the alarm 

+ QTest 

+ public void a normal pressure value after a value outside the range should 
not stop the alarm() { ~ a = = = = 

+ // Assert 

+ assertTrue (alarm.isAlarmOn () ); 


“有 了 前 面 的 测试 的 铺垫 ， 写 这 个 测试 就 很 容易 了 。 这 个 测试 要 求 先 检测 到 一 个 在 正常 范围 之 外 的 胎 压 值 并 报警 ， 然 后 再 检测 到 一 个 正常 范围 的 胎 压 值 且 不 应 把 之 前 的 报警 给 关闭 。 基 于 这 个 要 求 ， 咱 
们 可 以 分 两 步 来 实现 这 个 测试 的 Act 部 分 。 第 一 步 ， 先 调用 Stub 对 象 的 arr angeNextPressurePsiValue () 方法 ， 令 其 在 被 Alarm 对 象 调用 时 返回 Alarm.LOW _PRESSURE THRESHOLD-1 这 样 一 个 正常 范 
之 外 的 值 ， 然 后 调用 Alarm 类 的 check () 方法 来 检测 。 第 二 步 ， 调 用 Stub 对 象 的 arrangeNextPressurePsiValue () AIA, 令 其 在 被 Alarm 对 象 调用 时 返回 Alarm.LOW_PRESSURE_THRESHOLD 这 样 一 个 
在 正常 范围 之 内 的 值 ， 然 后 调用 Alarm 类 的 check () 方法 来 检测 。 测 试 写 完 后 ， 运 行 ， 通过。 这 样 ， 这 个 TODO 也 完成 了 ， 可 以 将 该 TODO 删 除 。” 


回 


完成 “跟随 在 正常 范围 之 外 的 胎 压 值 之 后 的 正常 胎 压 值 应 该 不 会 让 之 前 所 引发 的 警报 停止 。 这 个 TODO 的 代码 如 下 所 示 (CM: Finished TODO: a normal pressure value after a value outside the 


range should not stop the alarm.) : 


public class AlarmTest { 


// TODO-user-intent-test-working-on: a normal pressure value after a value 
outside the range should not stop the alarm 


@Test 
public void a_normal_pressure_value_after_a_value_outside_the_range_should_ 
not_stop_the_alarm() { 
// Arrange 
StubSensor stubSensor = new StubSensor (); 
Alarm alarm = new Alarm(stubSensor) ; 


// Act 
stubSensor .arrangeNextPressurePsiValue (Alarm. LOW_PRESSURE_THRESHOLD - 1); 
alarm.check () ; 


stubSensor .arrangeNextPressurePsiValue (Alarm. LOW_PRESSURE_THRESHOLD) ; 
alarm.check () ; 


十 十 十 十 十 十 十 十 十 十 十 


// Assert 
assertTrue (alarm.isAlarmOn () ) ; 


“现在 该 处 理 最 后 一 个 TODO， 即 那个 新 特性 “跟随 在 正常 范围 之 外 的 胎 压 值 之 后 的 正常 胎 压 值 应 该 能 让 之 前 所 引发 的 警报 停止 ”的 TODO 了 。 因为 这 个 新 特性 的 TODO 与 刚刚 编写 的 那个 用 户 意图 
TODO 在 功能 上 正好 相反 ， 所 以 可 以 把 前 一 个 TODO 的 测试 改造 一 下 ， 改 一 下 测试 名 字 ， 将 Assert 部 分 的 assertTrue () 方法 改 为 assertFalse () 方法 ， 就 成 为 现在 正在 处 理 的 TODO 的 测试 。 运 行 测试 ， 
失败 。 原 因 是 在 Alarm 类 的 check () 方法 中 每 次 检测 胎 压 值 前 清除 警报 ， 即 alarmOn 这 个 成 员 变 量 没有 在 每 次 检测 胎 压 值 之 前 赋值 为 false。 在 Alarm 类 的 check () 方法 开头 加 上 一 句 ‘alarmOn = 
false; ”就 好 了 。 " 


完成 新 特性 “跟随 在 正常 范围 之 外 的 胎 压 值 之 后 的 正常 胎 压 值 应 该 能 让 之 前 所 引发 的 警报 停止 ”的 TODO 的 代码 如 下 所 示 (CM: Finished the new feature TODO: a normal pressure value after a 


value outside the range should stop the alarm.) : 


public class AlarmTest { 


7 // TODO-new-feature: a normal pressure value after a value outside the range 
should stop the alarm 
@Test 
= public void a_normal_pressure_value_after_a_value_outside_the_range_ 
should_not_stop_the_alarm() { 


+ public void a_normal_pressure_value_after_a_value_outside_the_range_should_ 
stop_the_alarm() { 
// Arrange 


StubSensor stubSensor = new StubSensor () 7 
Alarm alarm = new Alarm(stubSensor) ; 


// Assert 
= assertTrue (alarm.isAlarmOn () ) ; 
+ assertFalse (alarm.isAlarmOn () ); 


} 
} 
public class Alam { 


public void check () 
{ 


+ 


alarmOn = false; 
double psiPressureValue = transducer.popNextPressurePsiValue () ; 


至 此 ， 这 个 有 关 胎 压 检 测 系统 的 编程 操练 就 告 一 段落 。 为 了 便于 和 


多 前 的 代码 进行 比较 ， 下 面 列 出 重 构 后 的 测试 代码 和 生产 代码 。 


public class AlarmTest { 

@Test 

public void a normal pressure value should not raise the alarm() { 
// Arrange 
StubSensor stubSensor = new StubSensor(); 
stubSensor.arrangeNextPressurePsiValue (Alarm. LOW_PRESSURE_THRESHOLD) ; 
Alarm alarm = new Alarm(stubSensor) ; 
// Act 
alarm. check () ; 
// Assert 
assertFalse (alarm. isAlarmOn () ); 

} 

@Test 

public void a pressure value outside the range should raise the_alarm() { 
// Arrange 
StubSensor stubSensor = new StubSensor(); 
stubSensor.arrangeNextPressurePsiValue (Alarm.HIGH_ PRESSURE THRESHOLD + 1); 
Alarm alarm = new Alarm(stubSensor) ; = a 
// Act 
alarm.check (); 
// Assert 
assertTrue (alarm. isAlarmOn ()); 

} 

@Test 

public void a_normal_pressure_value_after_a_value_outside_the_range_should_ 
stop the alarm() { 
// Arrange 
StubSensor stubSensor = new StubSensor () ; 
Alarm alarm = new Alarm(stubSensor) ; 
// Bot 
stubSensor.arrangeNextPressurePsiValue (Alarm. LOW_PRESSURE_THRESHOLD - 1); 
alarm. check () ; 
stubSensor.arrangeNextPressurePsiValue (Alarm. LOW_PRESSURE_THRESHOLD) ; 
alarm. check (); rs g 
// Assert 
assertFalse (alarm. isAlarmOn ()); 


后 Sensor 类 的 代码 如 下 所 示 : 


public class Sensor implements Transducer { 

public static final double OFFSET = 16; 

@Override 

public double popNextPressurePsiValue () 

{ 
double pressureTelemetryValue; 
pressureTelemetryValue = samplePressure( ); 
return OFFSET + pressureTelemetryValue; 

} 

private static double samplePressure () 

{ 
// placeholder implementation that simulate a real sensor in a real tire 
Random basicRandomNumbersGenerator = new Random (42) ; 
double pressureTelemetryValue = 6 * basicRandomNumbersGenerator. 

nextDouble() * basicRandomNumbersGenerator.nextDouble () ; 

return pressureTelemetryValue; 


后 Transducer 接 口 的 代码 如 下 所 示 : 


public interface Transducer { 
double popNextPressurePsiValue (); 


重 构 后 StubSensor 类 的 代码 如 下 所 示 : 


public class StubSensor implements Transducer { 
private double nextPressurePsiValue; 
public void arrangeNextPressurePsiValue (double nextPressurePsiValue) { 
this.nextPressurePsiValue = nextPressurePsiValue; 


} 

QOverride 

public double popNextPressurePsiValue() { 
return this.nextPressurePsiValue; 

} 


重 构 后 Alarm 类 的 代码 如 下 所 示 : 


public class Alarm { 
public static final double LOW PRESSURE THRESHOLD = 17; 
public static final double HIGH PRESSURE THRESHOLD = 21; 
private Transducer transducer = null; 
private boolean alarmOn = false; 
public Alarm() { 
this.transducer = new Sensor(); 


public Alarm(Transducer transducer) { 
this.transducer = transducer; 


} 
Public void check () 
{ 


alarmOn = false; 

double psiPressureValue = transducer.popNextPressurePsiValue (); 

if (psiPressureValue < LOW_PRESSURE_THRESHOLD || HIGH_PRESSURE_THRESHOLD < 
psiPressureValue) 

{ 
alarmOn = true; 


} 


} 
public boolean isAlarmOn () 
{ 

return alarmOn; 


} 


在 操练 了 Stub 编 写 和 接口 提取 的 编写 单元 测试 的 方法 后 ， 咱 们 可 以 再 操练 一 下 Mock 编 写 和 子 类 化 并 履 写 方法 的 方法 。 不 过 在 继续 操练 前 ， 咱 们 看 看 这 个 操练 都 做 了 哪些 工作 。 


1) 阅读 轮胎 气压 检测 系统 的 代码 ， 包 括 Sensor 类 和 Alarm 类 。 


2) 从 用 户 意图 而 不 是 具体 实现 的 角度 编写 新 特性 的 TODO。 


3) 记录 了 使 用 new 操 作 符 创建 的 Sensor 对 象 ， 从 而 违反 依赖 倒置 和 开 闭 原则 的 TODO。 


4) 记录 了 3 个 用 户 意图 测试 的 TODO。 


5) 先 写 了 测试 的 Assert 部 分 的 意图 代码 ， 然 后 再 推导 出 Act 和 Arrange 部 分 的 测试 意图 代码 ， 并 通过 修复 意图 代码 的 编译 和 测试 运行 错误 ， 来 驱动 出 生产 代码 ， 从 易 到 难 地 完成 上 述 TODO。 


6) 使 用 提取 接口 的 方法 ， 让 SUT 针 对 抽象 的 接口 ， 而 不 是 针对 具体 的 DOC 来 编程 。 先 从 DOC 中 提取 接口 ， 然 后 编写 Stub 类 实现 该 接口 ， 并 通过 SUT 的 带 有 上 述 接口 类 型 的 构造 器 ， 将 一 个 Stub 对 象 注 
入 SUT 对 象 中 ， 从 而 实现 让 SUT 把 易于 控制 的 Stub 类 当成 上 述 接口 来 看 待 ， 对 SUT 进 行 测试 。 


7) 通过 操练 我 们 学 到 了 以 下 技能 : 


a) 代码 虽然 易 读 ， 但 由 于 没有 测试 保护 ， 使 其 对 于 代码 维护 者 来 说 反馈 慢 ， 所 以 这 样 的 代码 还 是 属于 烂 代码 。 


b) 当 SUT 所 依赖 的 DOC 很 难 在 测试 中 进行 控制 时 ， 可 以 根据 DOC 提 取出 一 个 接口 ， 然 后 让 SUT 不 再 针对 DOC ， 而 是 针对 这 个 接口 编程 ， 并 根据 这 个 接口 编写 易于 控制 的 Test Double， 来 替代 那个 难 
以 控制 的 DOC， 从 而 令 SUT 把 Test Double 当 成 那个 接口 来 看 待 ， 进 而 对 SUT 进 行 测试 ， 来 解决 DOC 在 测试 时 难以 控制 的 问题 。 


c) Stub 和 Mock 都 属于 Test Double。 前 者 的 作用 是 让 测试 能 够 控制 SUT 的 间接 输入 ， 以 便于 测试 能 够 强制 SUT 进 入 正常 情况 下 很 难 进入 的 运行 路 径 中 ; 而 后 者 的 作用 是 让 测试 能 够 验证 SUT 的 间接 输 


d) 有 关 测试 TODO 应 该 针对 抽象 的 用 户 意图 来 编写 ， 而 不 要 针对 具体 的 编程 实现 逻辑 来 编写 ， 以 便 让 测试 变 得 强壮 而 不 是 变 得 脆弱 。 


e) 使 用 像 Isensor 这 样 命名 接口 的 方式 并 不 理想 ， 比 较 好 的 方法 是 用 translate.google.cn 来 寻找 一 个 类 名 的 英文 近义词 来 为 该 类 接口 命名 。 


[由 下 文中 有 关 SUT、DOC、Stub、Mock 和 Test Double 的 定义 ， 参 见 Gerard Meszaros, 《xUnit Test Patterns:Refactoring Test Code» , Addison-Wesley,May 31,2007. 


网 取 自 ThoughtWorks Studio 的 培训 师 和 教练 Luca Minudel 在 2012 年 设计 并 上 传 到 GitHub 上 的 编程 操练 系列 题目 TDD with Mock Objects, AJL: 
https: //github.com/lucaminudel /TDDwithMockObjectsAndDesignPrin ciples. 


B] AJL: https://github.com/wubin28 /tbc-tire-pressure-monitoring-system-java/tree/stub-with-extracting-interface 


第 17 章 ”分 而 测 之 一 一 编写 Mock 及 子 类 化 并 覆 写 方法 


为 了 解决 SUT 所 依赖 的 DOC 在 测试 中 难以 控制 的 问题 ， 我 们 可 以 使 用 刚刚 操练 的 编写 Stub 及 提取 接口 的 方法 。 除 此 之 外 ， 我 们 还 可 以 使 用 另 一 种 方法 ， 即 编写 Stub 及 子 类 化 并 覆 写 的 方法 。 现 在 咱们 就 
开始 做 Ticket Dispenser[1] 这 个 题目 ， 来 操练 一 下 后 者 。 


这 个 题目 是 有 关 自 动 取 号 系统 的 ， 类 似 于 去 银行 办 事 进门 时 取 号 的 那 种 取 号 机 。 有 3 个 类 : TurnTicket 类 表示 从 取 号 机 上 所 取 的 票 ， 票 上 印 着 号 码 ; TurnNumberSequence 类 用 于 产生 所 有 票 上 的 号 
码 ; 而 TicketDispenser 类 则 表示 取 号 机 ， 根 据 从 TurnNumberSequence 类 获得 的 号 码 来 出 票 。 这 个 题目 要 求 在 有 多 个 TicketDispenser 的 情况 下 ， 两 个 人 分 别 在 两 台 不 同 的 取 号 机 上 取 号 ， 不 能 取 到 同样 号 
码 的 票 。 操 练 这 个 题目 首先 要 为 TicketDispenser 类 编写 测试 ， 然 后 在 测试 的 保护 下 实现 两 个 新 特性 : VIP 客户 的 票 号 从 1001 开 始 ; 普通 (Regular) 客户 的 票 号 从 2001 开 始 。 


示 


“看 一 下 现 有 的 代码 [3 吧 。” 


源 代码 有 4 个 类 。 第 1 个 是 TurnTicket 类 ， 它 有 两 个 公共 接口 方法 ， 一 个 是 带 有 整 型 参数 turnNumber 的 构造 器 ， 用 来 把 票 号 保存 到 成 员 变量 中 ; 另 一 个 是 方法 getTurnNumber () ， 用 来 获取 票 号 。 


TurnTicket 类 的 代码 如 下 所 示 : 


public class TurnTicket { 

private final int turnNumber; 
public TurnTicket (int turnNumber) 
{ 

this.turnNumber = turnNumber; 
} 
public int getTurnNumber () 
{ 

return turnNumber; 


} 


回 


第 2 个 类 是 TurnNumberSequence， 它 只 有 一 个 公共 接口 方法 ， 就 是 静态 的 getNext-TurnNumber () 方法 ， 返 


静态 的 成 员 变量 turnNumber 的 值 ， 然 后 将 其 增 1。 


TurnNumberSequence 类 的 代码 如 下 所 示 : 


public class TurnNumberSequence { 
private static int turnNumber = 0; 
public static int getNextTurnNumber () 
{ 
return _turnNumber++; 


} 


第 3 个 类 是 TicketDispenser， 它 也 只 有 一 个 公共 接口 方法 ， 即 getTurnTicket () 方法 。 这 个 方法 从 TurnNumbersequence 那 里 得 到 下 一 张 票 的 票 号 ， 然 后 用 这 个 票 号 创 寻 


Mi 


一 张 票 ， 并 返回 该 票 。 


TicketDispenser 类 的 代码 如 下 所 示 : 


public class TicketDispenser { 
public TurnTicket getTurnTicket () 
{ 
int newTurnNumber = TurnNumberSequence.getNextTurnNumber () ; 
TurnTicket newTurnTicket = new TurnTicket (newTurnNumber) ; 
return newTurnTicket; 


最 后 一 个 类 是 TicketDispenserTest 测 试 类 ， 里 面 只 有 一 个 测试 ， 来 判断 2+ 3 等 于 5， 用 来 测试 JUnit 能 否 正常 运行 。 把 光标 移动 到 这 个 测试 类 名 上 ， 然 后 按 Ctrl+ Shift+ F10 组 合 键 ， 运 行 一 下 这 个 测试 。 


读 完 代 码 后 ， 现 在 可 以 写 一 些 TODO， 来 记录 一 下 接 下 来 要 做 的 事情 。 


“和 上 一 个 操练 题目 类 似 ， 我 发 现在 TicketDispenser 类 中 的 getTurnTicket () 方法 里 ， ‘TurnNumberSequence.getNextTurnNumber () ; ′ 这 条 语句 调用 了 TurnNumberSequence 类 的 
getNextTurnNumber () 静态 方法 ， 属 于 针对 具体 实现 编程 ， 而 不 是 针对 抽象 编程 ， 违 反 了 依赖 倒置 和 开 闭 原则 。” 


没 错 。 写 个 TODO 记 录 下 来 。 


在 TicketDispenser 类 中 添加 依赖 静态 方法 进行 编程 的 TODO 代 码 如 下 所 示 (CM: Added TODO: Depending on a static method violates the Dependency Inversion Principle and Open- 
Closed Principle.) : 


public class TicketDispenser { 
public TurnTicket getTurnTicket () 
{ 
+ // TODO: Depending on a static method violates the Dependency Inversion 
Principle and Open-Closed Principle. 
int newTurnNumber = TurnNumberSequence.getNextTurnNumber () ; 


可 以 再 写 两 个 TODO 来 记录 两 个 新 特性 : VIP 客户 的 票 号 从 1001 开 始 ， 和 普通 (Regular) 客户 的 票 号 从 2001 开 始 。 


在 TicketDispenserTest 类 中 添加 两 个 有 关 新 特性 的 TODO 代 码 如 下 所 示 (CM: Added two new feature TODOs for the different sequence starting numbers of VIP and regular 


customers.) : 


public class TicketDispenserTest { 


+ // TODO-new-feature: the turn number sequence of the vip customers starts from 1001 
+ // TODO-new-feature: the turn number sequence of the regular customers 
starts from 2001 
} 


能 想 出 有 什么 用 户 意图 的 测试 TODO 吗 ? 


[ 


“我 能 想到 的 有 两 个 。 一 个 是 新 出 的 票 的 票 号 要 比 前 一 张 票 的 票 号 要 大 ， 另 一 个 是 新 出 的 票 的 票 号 要 比 在 另 一 台 取 号 机 上 所 取 的 前 一 张 票 的 票 号 要 大 。 " 


za 


好 的 ， 写 两 个 用 户 意图 测试 的 TODO。 


在 TicketDispenserTest 类 中 添加 两 个 有 关 用 户 意 


网 


的 测试 TODO 的 代码 如 下 所 示 (CM: Added 2 user intent test TODOS.) : 


public class TicketDispenserTest { 


+ // TODO-user-intent-test: a new ticket should have the turn number subsequent 
to the previous ticket 
+ // TODO-user-intent-test: a new ticket should have the turn number subsequent 


to the previous ticket from another dispenser 


我 再 添加 一 个 需要 做 单元 测试 的 TODO: 如 果 给 取 号 机 11 这 个 票 号 ， 那 么 取 号 机 应 该 能 打印 出 一 张 印 有 11 这 个 号 码 的 票 


示 。 


在 TicketDispenserTest 类 中 添加 单元 测试 的 TODO 的 代码 如 下 所 示 (CM: Added an unit test TODO for class TicketDispenser.) : 


public class TicketDispenserTest { 


+ // TODO-unit-test: the ticket dispenser should dispense the ticket number 


比 前 一 张 票 号 大 1。 


SU 


TurnTicket。 它 的 值 来 自 调用 一 个 名 为 ticketDispenser 的 取 号 机 对 象 的 getTurnTicket () 方法 的 返 


11 if give a turn number 11 to it 


E 


TODO 写 得 差不多 了 ， 下 面 该 挑 一 个 简单 的 先 做 。 那 个 “新 票 比 前 一 张 的 票 号 要 大 ”的 TODO 看 起 来 简单 ， 先 做 它 。 写 一 个 这 个 TODO 的 测试 方法 ， 再 写 它 的 Assert 部 分 的 意图 代码 ， 来 判断 新 票 号 


将 新 票 比 前 一 张 的 票 号 要 大 的 TODO 标 记 为 working-on， 并 编写 该 TODO 的 测试 和 Assert 部 分 的 意图 代码 如 下 所 示 (CM: Working on TODO: a new ticket should have the turn number 


bsequent to the previous ticket.Wrote an assertion for its test.) : 


public class TicketDispenserTest { 


> // TODO-user-intent-test: a new ticket should have the turn number subsequent 
to the previous ticket 


+ // TODO-user-intent-test-working-on: a new ticket should have the turn number 
subsequent to the previous ticket 
+ @Test 


+ public void a new ticket should have the turn number subsequent to the 

previous ticket() { E G e ~ a “ns a 

// Assert 

assertEquals (1, newTicket.getTurnNumber() - previousTicket.getTurnNumber () ) 


a 


i; ++ 


在 这 行 assertEquals () 语句 中 ，newTicket 和 previousTicket 是 有 编译 错误 的 红色 ， 因 为 它们 都 未 创建 。 先 把 光标 定位 在 newTicket 上 ， 按 Alt+Enter 快 捷 键 来 创建 这 个 本 地 变量 ， 类 型 是 
值 。 类 似 地 再 创建 previousTicket 这 个 本 地 变量 。 最 后 创建 ticketDispenser 这 个 本 地 变量 ， 它 的 类 型 


回 


是 TicketDispenser， 它 的 值 来 自 new 出 来 的 一 个 TicketDispenser 对 象 。 写 完 代 码 后 ， 按 Ctrl+ F5 快 捷 键 运行 测试 ， 通 过 。 这 个 TODO 就 完成 了 ， 可 以 删除 。 


完成 新 票 比 前 一 张 的 票 号 要 大 的 TODO 的 代码 如 下 所 示 (CM: Finished TODO: a new ticket should have the turn number subsequent to the previous ticket.) : 


public class TicketDispenserTest { 
@Test 
= // TODO-user-intent-test-working-on: a new ticket should have the turn 
number subsequent to the previous ticket 
public void a new ticket should have the turn_number subsequent to the 
previous ticket() { 7 > ee: E F 人 


+ // Arrange 
+ TicketDispenser ticketDispenser = new TicketDispenser (); 
fe TurnTicket previousTicket = ticketDispenser.getTurnTicket (); 
+ 
+ // Act 
+ TurnTicket newTicket = ticketDispenser.getTurnTicket () ; 
+ 
// Assert 
assertEquals (1, newTicket.getTurnNumber() - previousTicket.getTurnNumber () ); 


现在 可 以 再 做 那个 “新 票 比 另 一 台 取 号 机 上 出 的 前 一 张 票 的 票 号 要 大 ”的 TODO 了 。 把 它 标记 为 working-on， 并 编写 相应 的 测试 和 Assert 部 分 的 意图 代码 。 


将 新 票 比 另 一 台 取 号 机 上 出 的 前 一 张 票 的 票 号 要 大 的 TODO 标 记 为 working-on， 并 编写 相应 的 测试 和 Assert 部 分 的 意图 代码 如 下 所 示 (CM: Working on TODO: a new ticket should have the 


turn number subsequent to the previous ticket from another dispenser.Wrote an assertion for its test.) : 


F 


a 


public class TicketDispenserTest { 


// TODO-user-intent-test: a new ticket should have the turn number subsequent 
to the previous ticket from another dispenser 


+ // TODO-user-intent-test-working-on: a new ticket should have the turn number 
subsequent to the previous ticket from another dispenser 
+ @Test 


+ public void a_new_ticket_should_have_the_turn_number_subsequent_to_the_ 
previous ticket from another dispenser() { 

+ // Assert = = jj 

assertEquals (1, newTicket.getTurnNumber() - previousTicket.getTurnNumber () ) 


在 意图 代码 中 ， 还 是 newTicket 和 previousTicket 这 两 个 变量 是 编译 错误 的 红色 。 可 以 用 类 似 前 面 的 做 法 推导 出 测试 的 Act 和 Arrange 部 分 ， 只 不 过 这 一 次 previousTicket 要 出 自 另 一 台 取 号 机 。 写 完 代 
后 ， 按 Ctrl+F5 快 捷 键 运行 测试 ， 通 过 。 这 个 TODO 就 完成 了 ， 可 以 删除 。 


完成 新 票 比 另 一 台 取 号 机 上 出 的 前 一 张 票 的 票 号 要 大 的 TODO 的 代码 如 下 所 示 (CM: Finished TODO: a new ticket should have the turn number subsequent to the previous ticket from 


another dispenser.) : 


public class TicketDispenserTest { 


= // TODO-user-intent-test-working-on: a new ticket should have the turn number 
subsequent to the previous ticket from another dispenser 
@Test 
public void a_new_ticket_should_have_the_turn_number_subsequent_to_the_ 
previous_ticket_from_another_dispenser() { 


E // Arrange 
中 TicketDispenser anotherTicketDispenser = new TicketDispenser () 7 
+ TicketDispenser ticketDispenser = new TicketDispenser (); 
+ 
+ // Act 
of TurnTicket previousTicket = anotherTicketDispenser.getTurnTicket () ; 
+ TurnTicket newTicket = ticketDispenser.getTurnTicket () ; 
+ 
// Assert 
assertEquals (1, newTicket.getTurnNumber() - previousTicket.getTurnNumber () ); 


现在 该 做 那个 单元 测试 的 TODO 了 : 给 取 号 机 11 就 能 打印 出 一 张 号 码 是 11 的 票 。 还 是 编写 这 个 TODO 的 测试 的 Assert 部 分 ， 断 言 出 的 票 的 号 码 是 11。 


将 单元 测试 “给 取 号 机 11 就 能 打印 出 一 张 号 码 是 11 的 票 ”的 TODO 标 记 为 working-on， 并 编写 相应 测试 的 Assert 部 分 的 代码 如 下 所 示 (CM: Working on TODO'the class Ticket-Dispenser should 


dispense the ticket number 11 if give a turn number 11 it'and wrote the Assert part of its test.) : 


public class TicketDispenserTest { 


= // TODO-unit-test: the class TicketDispenser should dispense the ticket number 11 
if give a turn number 11 to it 


+ // TODO-unit-test-working-on: the class TicketDispenser should dispense the 
ticket number 11 if give a turn number 11 to it 

+ @Test 

+ public void the class TicketDispenser_should_dispense the ticket _number 
11 if give a turn number 11 to_it() { ` py = S 

+ // Assert 

+ assertEquals (11, ticket.getTurnNumber () ) ; 


接 下 来 要 从 测试 的 Assert 部 分 推导 出 Act 和 Arrange 部 分 了 。Act 部 分 和 前 
ticketDispenser 本 地 变量 是 TicketDispenser 类 型 ， 其 值 来 


这 里 ，TicketDispenser 类 是 SUT， 而 TicketDispenser 类 所 依赖 的 TurnNumberSequence 类 就 是 DOC。 


H 


类 似 ，ticket 本 地 变量 是 TurnTicket 类 型 ， 
自 该 类 new 出 来 的 一 个 对 象 。 


于 这 个 DOC 中 所 保存 的 下 一 个 票 号 在 每 一 次 获取 票 号 后 就 


由 


口 ， 然 后 让 SUT 不 再 针对 DOC， 而 是 针对 这 个 接 


这 个 DOC 就 打印 出 一 个 票 号 为 11 的 票 。 前 
编写 易于 控制 的 Test Double， 比 如 让 它 能 打印 出 11 这 个 票 号 ， 


题 。 


前 面 咱们 操练 了 接口 


提取 的 方法 ， 现 在 咱们 换 一 种 方法 来 操练 。 这 种 方法 叫 子 类 化 并 覆 写 方法 。 


讲 过 ， 当 SUT 所 依赖 的 DOC 很 难 在 测试 中 进行 控制 时 ， 就 可 以 根据 DOC 提 取 一 个 接 
来 蔡 代 这 个 难以 控制 的 DOC， 从 而 令 SUT 把 Test Double 当 成 那个 接 


H 


来 看 待 ， 进 


， 而 是 把 DOC 就 当成 接 


体 说 来 ， 后 者 不 像 前 者 那样 需要 根据 DOC 来 提取 接 


接口 编程 。 然 


后 编写 DOC 这 个 接 


le 


一 个 子 类 ， 不 妨 命名 为 MockTurnNumberSequence， 并 把 MockTurnNumberSequence 类 当成 易于 控制 的 Test Doub! 


试 中 控制 的 方法 。 最 后 


这 个 子 类 来 蔡 代 这 个 难以 控制 


的 DOC 父 类 。 


“这 个 题目 的 DOC 是 TurnNumberSequence 类 是 一 个 具体 的 类 ， 不 是 一 个 接口 


这 里 TurnNumberSequence 类 确实 被 定义 为 一 个 


TurnNumberSequence 这 个 接 


虽然 咱们 现在 是 在 操练 Mock， 但 Mock 和 Stub 都 
口 来 看 待 。 


虽然 现在 TicketDispenser 类 已 经 针对 TurnNumberSequence 这 个 类 编程 了 ,但 TurnNumberSequence 这 个 类 里 


呀 ?“ 


]， 但 可 以 被 当成 接 


体 的 类 ， 而 不 是 一 个 接 


属于 Test Double， 所 以 可 以 仿照 前 面 


面 全 是 静态 方法 和 静态 成 员 变 量 ， 


值 来 自 取 号 机 对 象 ticketDispenser 的 getTurnTicket () 方法 的 返 


来 用 。 在 一 个 符合 里 氏 蔡 换 原 则 B] 的 父 类 和 子 类 的 继承 关系 中 ， 父 类 就 可 以 被 看 作 是 子 类 的 接 


需要 改造 一 下 才能 成 为 一 个 好 


值 。 


回 


自动 增 1， 所 以 在 测试 中 难以 控制 让 
口 来 编程 ， 并 根 
而 测试 这 个 SUT， 从 而 解决 DOC 在 测试 中 难以 控制 的 问 


居 这 个 接口 


， 让 SUT 根 据 DOC 这 个 


在 这 个 子 类 中 覆 写 其 DOC 父 类 中 难以 在 测 


u 


操练 stub 的 做 法 来 做 。 现 在 要 做 的 是 ， 让 TicketDispenser 类 把 MockTurnNumberSequence 类 当成 


的 接口 。 在 根据 父 


类 TurnNumberSequence 编 写 了 子 类 MockTurnNumberSequence 后 ， 需 要 在 SUT 中 让 子 类 的 对 象 替 换 掉 父 类 的 对 象 。 所 以 需要 通过 TicketDispenser 类 的 带 有 TurnNumberSequence 类 型 的 构造 器 ， 将 
一 个 MockTurnNumberSequence 对 象 注入 TicketDispenser 对 象 中 。 


图 


咱们 可 以 使 


这 个 编程 意 


[ 


， 来 在 测试 中 编写 意图 代码 。 先 让 形 参 为 TurnNumber-Sequence 的 TicketDispenser 类 的 构造 器 接受 mockTurnNumberSequence 这 个 实 参 类 型 为 


MockTurnNumberSequence| 


对 象 帮助 验证 ,六 


verifyMethodGetNextTurnNumberCalledOnce () 方法 ， 来 验证 这 个 SUT 的 间接 输出 。 


完成 the_class_ TicketDispenser_should_dispense_the_ticket_number_11_if_give_a_turn_number_11_to it () 测试 方法 的 意图 


试 运行 结束 前 ， 在 TurnNumberSequence 这 个 接 


之 外 ， 其 他 步骤 都 和 前 面 Stub 的 操练 很 类 似 。 但 前 面 咱们 讲 到 了 Stub 和 Mock 的 


后 让 mockTurnNumberSequence 对 象 调 


区 别 。 


它 的 arrangeNextTurnNumber () 方法 ,来 将 期 望 的 票 号 11 传 进去 。 到 此 为 止 ， 除了 子 类 化 和 
Mock 要 比 Stub 多 做 一 件 事 ， 即 验证 SUT 的 间接 输出 。 在 这 里 ， 我 们 可 以 让 mockTurnNumberSequence 这 个 Mock 


变量 命名 中 有 Mock 


了 一 次 。 所 以 在 测试 的 最 后 让 mockTurnNumberSequence 对 象 调 


口中 的 getNextTurnNumber () 方法 被 调 


the_class_TicketDispenser_should_dispense_the_ticket_number_11_if_give_a_turn_number_11_to_it () .) : 


public class TicketDispenserTest { 


// ToODO-unit-test-working-on: the class TicketDispenser should dispense the 
ticket number 11 if give a turn number 11 to it 


@Test 


public void the_class_TicketDispenser_should_dispense_the_ticket_number_11_ 
if give a turn number 11 to it() { 


// Act 


十 十 十 十 十 十 十 十 


// Assert 


// Arrange 


MockTurnNumberSequence mockTurnNumberSequence = new MockTurnNumberSequence () 7 
mockTurnNumberSequence. arrangeNextTurnNumber (11) ; 
TicketDispenser ticketDispenser = new TicketDispenser (mockTurnNumberSequence) ; 


TurnTicket ticket = ticketDispenser.getTurnTicket () ; 


assertEquals (11, ticket.getTurnNumber () ) ; 


mockTurnNumberSequence. veri fyMethodGetNextTurnNumberCalledOnce () 7 


写 好 了 这 个 单元 测试 的 意 


于 ， 看 到 一 些 红色 的 编译 错误 。 先 修复 MockTurn-NumberSequence 这 个 红色 的 编译 错误 。 创 建 MockTurnNumberSequence 类 。 


代码 


创建 MockTurnNumberSequence 类 以 修复 编程 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Created class MockTurnNumberSequence.) : 


+public class MockTurnNumberSequence { 


+} 


接 下 来 修复 arrangeNextTurnNumber () 方法 的 红色 编译 错误 ， 在 MockTurnNumber-Sequence 类 中 创建 该 方法 。 


在 MockTurnNumberSequence 类 中 创建 方法 arrangeNextTurnNumber () 以 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Created method 


MockTurnNumberSequence.arrangeNextTurnNumber () .) : 


public class MockTurnNumberSequence { 


十 

十 

本 } 
} 


public void arrangeNextTurnNumber (int nextTurnNumber) { 


在 TicketDispenser 类 中 创建 带 有 TurnNumberSequence 类 型 参数 的 构造 器 以 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixing compiler error: Created constructor 


TicketDispenser (TurnNumberSequence) .) : 


public class TicketDispenser { 


+ 
+ 
+ } 


创建 了 一 个 带 有 参数 的 TicketDispenser 类 的 构造 器 


public TicketDispenser (TurnNumberSequence turnNumberSequence) { 


后 ， 前 面 写 的 测试 代码 中 “new TicketDispenser () ; " 


代码 如 下 所 示 (CM: Wrote intention code for the test 


下 面 该 修复 TicketDispenser 类 的 构造 器 参数 mockTurnNumberSequence 有 一 条 红色 下 划 波 浪 线 的 编译 错误 了 。 在 TicketDispenser 类 中 创建 带 有 TurnNumberSequence 类 型 参数 的 构造 器 。 


语句 中 括号 下 面 就 出 现 了 表示 编译 错误 的 红色 波浪 线 。 这 需要 咱们 再 显示 定义 


TicketDispenser 类 的 默认 构造 器 ， 来 修复 错误 。 在 默认 构造 器 中 ， 可 以 调用 刚刚 创建 的 带 有 TurnNumberSequence 类 型 参数 的 构造 器 ， 并 传 入 一 个 new 出 来 的 TurnNumbersequence 对 象 。 


创建 TicketDispenser 默 认 构 造 器 以 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixing compiler error: Created constructor TicketDispenser () .) : 


Public class TicketDispenser { 


public TicketDispenser() { 
this (new TurnNumberSequence () ) 7 


++ 


+ } 


现在 ， 在 测试 代码 中 ，TicketDispenser 类 的 构造 器 参数 mockTurnNumberSequence 下 面 的 红色 下 划 波 浪 线 依然 存在 。 用 鼠标 指向 它 看 看 编译 错误 ， 发 现 是 MockTurnNumbersequence 类 尚未 继承 
TurnNumberSequence 类 。 现 在 修复 它 。 


让 MockTurnNumberSequence 类 继承 TurnNumberSequence 类 以 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Made class MockTurnNumberSequence extend class 


TurnNumber-Sequence.) : 


-public class MockTurnNumberSequence { 
+public class MockTurnNumberSequence extends TurnNumberSequence { 


最 后 在 测试 代码 中 ， 就 剩 下 尚未 创建 MockTurnNumberSequence 类 的 verifyMethodGetNextTurnNumberCalledOnce () 方法 这 个 编译 错误 了 。 修 复 它 。 


创建 MockTurnNumberSequence 类 的 verifyMethodGetNextTurnNumberCalledOnce () 方法 以 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Created method MockTurn- 
NumberSequence.verifyMethodGetNextTurnNumberCalledOnce () .) : 


public class MockTurnNumberSequence extends TurnNumberSequence { 
+ public void verifyMethodGetNextTurnNumberCalledOnce() { 
+ 
+ } 
} 


测试 代码 中 的 红色 编译 错误 都 没有 了 。 可 以 按 Ctrl+F5 快 捷 键 运行 下 测试 。 前 两 个 测试 通过 ， 最 后 这 个 正在 写 的 测试 失败 ， 有 断言 错误 。 错 误 信息 中 说 ， 期 望 值 是 11， 但 实际 值 是 4。 测 试 失败 的 原因 是 
咱们 刚才 修复 编译 错误 的 代码 都 是 内 部 没有 具体 实现 的 空 方法 。 咱 们 可 以 从 上 往 下 检查 一 遍 这 个 单元 测试 的 TODO 的 测试 代码 ， 把 那些 空 方法 都 实现 完整 了 。 先 实现 MockTurnNumberSequence 类 的 
arrangeNextTurnNumber () 方法 ， 把 该 方法 传 入 的 nextTurnNumber 参 数 的 值 保 存 到 该 类 的 成 员 变 量 中 。 


实现 MockTurnNumberSequence 类 的 arrangeNextTurnNumber () 方法 以 修复 断言 错误 的 代码 如 下 所 示 (CM: Fixing assertion error: Saved the parameter nextTurnNumber of method 


MockTurnNumberSequence.arrangeNextTurnNumber () into the field nextTurnNumber of class MockTurnNumberSequence.) : 


public class MockTurnNumberSequence extends TurnNumberSequence { 
+ private int nextTurnNumber; 

public void arrangeNextTurnNumber (int nextTurnNumber) { 
+ this.nextTurnNumber = nextTurnNumber; 

} 


接 下 来 继续 实现 这 个 测试 代码 中 下 一 个 空 方 法 一 一 TicketDispenser 类 的 带 MockTurn-NumberSequence 类 型 参数 的 构造 器 ， 把 构造 器 传 进 的 参数 turnNumberSequence 的 值 保存 在 该 类 的 成 员 变 量 
中 。 


实现 TicketDispenser 类 的 带 MockTurnNumberSequence 类 型 参数 的 构造 器 以 修复 断言 错误 的 代码 如 下 所 示 (CM: Fixing assertion error: Saved the parameter turnNumberSequence of 


constructor TicketDispenser (TurnNumberSequence) into the field turnNumberSequence of class TicketDispenser.) : 


public class TicketDispenser { 
中 private TurnNumberSequence turnNumberSequence; 

public TicketDispenser (TurnNumberSequence turnNumberSequence) { 
+ this.turnNumberSequence = turnNumberSequence; 

} 


测试 代码 接 下 来 就 该 调用 TicketDispenser 类 的 getTurnTicket () 方法 了 。 这 个 方法 虽然 不 是 空 方法 ， 但 是 里 面 有 咱们 先前 写 的 依赖 静态 方法 进行 编程 的 TODO。 现 在 也 到 了 处 理 这 个 TODO 的 时 候 
了 。 把 调用 TurnNumberSequence 类 的 静态 方法 getNextTurnNumber () 的 语句 ， 改 为 调用 turnNumberSsequence 对 象 的 成 员 方法 getNextTurnNumber () 这 样 的 意图 代码 。 另 外 ， 在 
TurnNumberSequence 类 中 ,把 getNextTurnNumber () 方法 前 面 的 static 修 饰 去 掉 ， 从 而 让 其 子 类 可 以 对 其 进行 覆 写 。 这 样 就 完成 了 处 理 依赖 静态 方法 进行 编程 的 TODO。 


完成 依赖 静态 方法 进行 编程 的 TODO 以 修复 断言 错误 的 代码 如 下 所 示 (CM: Fixing assertion error: Finished TODO: Depending on a static method violates the Dependency Inversion 
Principle and Open-Closed Principle.) : 


public class TicketDispenser { 
public TurnTicket getTurnTicket () 


= // TODO: Depending on a static method violates the Dependency Inversion 
Principle and Open-Closed Principle. 

= int newTurnNumber = TurnNumberSequence .getNextTurnNumber () ; 

ai int newTurnNumber = turnNumberSequence .getNextTurnNumber () ; 


public class TurnNumberSequence { 
private static int _turnNumber = 0; 
- public static int getNextTurnNumber () 
中 Public int getNextTurnNumber () 
{ 
return _turnNumber++; 


} 


Ja, MockTurnNumberSequenceix tPA S VAT urnNumberSequencefJget-NextTurnNumber () 方法 ， 现 在 给 加 上 ， 让 它 直接 返回 MockTurnNumberSequence 类 成 员 变 量 中 保存 
的 下 一 张 票 号 nextTurnNumber。 这 一 步 操作 就 是 子 类 化 并 覆 写 方法 ”命名 的 由 来 吧 。 


MockTurnNumberSequence 类 覆 写 父 类 TurnNumberSequence 的 getNextTurnNumber () 方法 的 代码 如 下 所 示 (CM: Fixed assertion error: Overrode method getNextTurnNumber () in 


class MockTurnNumberSequence.) : 


public class MockTurnNumberSequence extends TurnNumberSequence { 


@Override 
public int getNextTurnNumber() { 
return this.nextTurnNumber; 


十 十 十 二 十: 


} 


按 Ctrl+F5 快 捷 键 运行 测试 ， 通 过 。 现 在 完成 了 那个 单元 测试 的 TODO， 可 以 把 它 删 除 。 接 下 来 可 以 处 理 第 一 个 新 特性 的 TODO: VIP 客 户 的 票 号 从 1001 开 始 。 可 以 把 这 个 TODO 标 记 为 working-on， 


并 写 下 其 对 应 的 测试 的 Assert 部 分 ， 判 断 取出 的 票 号 为 1001。 


完成 给 出 11 就 打印 出 11 号 票 的 单元 测试 的 TODO， 并 把 新 特性 TODO VIP 客户 的 票 号 从 1001 开 始 标记 为 working-on， 且 编写 其 测试 的 Assert 部 分 的 代码 如 下 所 示 (CM: Finished TODO: the class 


TicketDispenser should dispense the ticket number 11 if give a turn number 11 to it.Working on TODO: the turn number sequence of the vip customers starts from 1001.Wrote a test with 


the Assert part of it.) : 


public class TicketDispenserTest { 


i 十 十 十 十 十 


下 


“等 等 ，MockTurnNumberSequence 类 


// TODO-unit-test-working-on: the class TicketDispenser should dispense the 
ticket number 11 if give a turn number 11 to it 


// TODO-new-feature: the turn number sequence of the vip customers starts 
from 1001 


// TODO-new-feature-working-on: the turn number sequence of the vip customers 
starts from 1001 

@Test 

public void the turn number sequence of the vip customers starts from_1001() { 
// Assert ~ N 7 Puch 7 w T 
assertEquals (1001, ticket.getTurnNumber () ); 

} 

面 接着 写 这 个 测试 的 Act 和 Arrange 的 意图 代码 。 


哦 ， 对， 忘记 实现 了 。 顺 便 写 个 TODO 记 下 来 。 


完成 the turn number sequence of the vip customers starts from_1001 () 测试 的 Act 和 Arrange 部 分 的 意 | 


NverifyMethodGetNextTurnNumberCalledOnce () 方法 还 没 实现 呢 。” 


区 


代码 并 添加 实现 MockTurnNumberSequence 类 的 


verifyMethodGetNextTurnNumberCalledOnce () 方法 的 TODO 的 代码 如 下 所 示 (CM: Wrote the intention code of Act and Arrange parts of the test 


the turn number sequence of the vip customers starts from_1001 () .Added TODO: Finish the implementation of method 


MockTurnNumberSequence.verifyMethodGetNextTurnNumberCalledOnce () .) : 


public class TicketDispenserTest { 


// TODO-new-feature-working-on: the turn number sequence of the vip customers 
starts from 1001 

@Test 

public void the turn number sequence of the vip customers starts from_1001() { 
// Arrange — T F ka he = a T 


TurnNumberSequence vipCustomerTurnNumberSequence = new TurnNumberSequence (1001) ; 


TicketDispenser vipCustomerTicketDispenser = new TicketDispenser 
(vipCustomerTurnNumberSequence) ; 


// Act 
TurnTicket ticket = vipCustomerTicketDispenser.getTurnTicket () ; 


// Assert 
assertEquals (1001, ticket.getTurnNumber () ); 
} 


public class MockTurnNumberSequence extends TurnNumberSequence { 


+ 


// TODO: Finish the implementation of method MockTurnNumberSequence. 
verifyMethodGetNextTurnNumberCalledOnce () . 

public void verifyMethodGetNextTurnNumberCalledOnce() { 

} 


在 刚刚 写 的 测试 的 意图 代码 中 ，“new TurnNumberSequence (1001) ; ”语句 中 1001 下 面 有 表示 编译 错误 的 红色 波浪 下 划 线 ， 因 为 TurnNumberSequence 类 还 没有 整 型 参数 的 构造 器 。 现 在 修复 
它 ， 在 这 个 构造 器 中 ， 把 传 入 的 firstNumber 参 数值 赋值 给 TurnNumberSequence 类 的 turnNumber 静 态 成 员 变 量 。 


在 类 TurnNumberSequence 类 中 创 寻 


TurnNumberSequence (int) .) : 


public class TurnNumberSequence { 


+ 
+ 
+ 


运行 测试 ， 发 现 编译 错误 。 原 


private static int _turnNumber = 0; 

public TurnNumberSequence (int firstNumber) { 
this. _turnNumber = firstNumber; 

} 


带 有 int 类 型 参数 的 构造 器 ， 并 传递 参数 0。 


因 是 刚刚 新 增 了 带 有 int 类 型 参数 的 TurnNumberSequence 类 的 构造 器 后 


LE 带 有 整 型 参数 的 构造 器 以 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Created and implemented constructor 


， 忘 记 显 式 地 定义 默认 的 TurnNumberSequence 类 的 构造 器 了 。 现 在 加 上 ， 让 默认 的 构造 器 调 


创建 并 实现 TurnNumberSequence 类 的 默认 构造 器 以 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Created and implemented constructor TurnNumberSequence () .) : 


public class TurnNumberSequence { 


+ 


+ 
+ 


public TurnNumberSequence() { 
this (0); 
} 


运行 测试 ， 通 过 。 现 在 完成 了 新 特性 TODO VIP 客户 的 票 号 从 1001 开 始 ， 可 以 把 它 删除 。 接 下 来 处 理 刚刚 新 加 上 实现 MockTurnNumberSequence 类 的 


verifyMethodGetNextTurnNumberCalledOnce () 方法 的 TODO， 把 它 标记 为 working-on。 在 verifyMethodGetNextTurnNumberCalledOnce () 方法 中 ， 可 以 先 编写 意 
次 数 的 成 员 变 量 callsCount 不 是 1 的 话 ， 就 抛 lllegalStateException 异 常 。 


在 MockTurnNumberSequence 类 的 verifyMethodGetNextTurnNumberCalledOnce () 方法 中 ， 编 写意 | 


Sequence.verifyMethodGetNextTurnNumberCalledOnce () .) : 


public class MockTurnNumberSequence extends TurnNumberSequence { 


十 十 


// TODO-working-on: Finish the implementation of method MockTurnNumberSequence. 
verifyMethodGetNextTurnNumberCalledOnce () . 
public void verifyMethodGetNextTurnNumberCalledOnce() { 


if (this.callsCount != 1) { 
throw new IllegalStateException ("The method getNextTurnNumber () 
should be called once."); 


网 


代码 ， 即 如 果 记 录 方 法 调 


代码 的 代码 如 下 所 示 (CM: Wrote intention code for method MockTurnNumber- 


[ 


因 


代码 中 ，callsCount 是 有 编译 错误 的 红色 ， 


在 这 段 意 | 为 尚未 创建 该 成 员 变量 。 现 在 就 创建 ， 并 初始 化 为 0。 


在 MockTurnNumberSequence 类 中 创建 并 初始 化 成 员 变 量 callsCount 以 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Created and initialized field callsCount in class 


MockTurnNumberSequence.) : 


public class MockTurnNumberSequence extends TurnNumberSequence { 
private int nextTurnNumber; 
private int callsCount = 0; 


+ 


运行 测试 ， 失 败 ， 发 现 lllegalStateException 异 常 。 原 因 


是 在 MockTurnNumberSequence 类 中 ， 方 法 getNextTurnNumber () 被 调 


时 ， 尚 未 将 callsCount 这 个 成 员 变 量 增 1。 


现在 修复 它 。 再 : 


行 测试 ， 通 过 。 现 在 就 完成 了 实现 MockTurnNumberSequence 类 的 verifyMethodGetNextTurnNumberCalledOnce () 方法 的 TODO， 可 以 删除 掉 。 


IB 


完成 实现 MockTurnNumberSequence 类 的 verifyMethodGetNextTurnNumberCalledOnce () 方法 的 TODO 的 代码 如 下 所 示 (CM: Fixed IllegalStateException: Made callsCount plus one in 


method MockTurnNumberSequence.getNextTurnNumber () .Finished TODO: Finish the implementation of method 
MockTurnNumberSequence.verifyMethodGetNextTurnNumberCalledOnce () .) : 


public class MockTurnNumberSequence extends TurnNumberSequence { 
= // TODO-working-on: Finish the implementation of method MockTurnNumberSequence. 
verifyMethodGetNextTurnNumberCalledOnce () . 
public void verifyMethodGetNextTurnNumberCalledOnce() { 
if (this.callsCount != 1) { 
throw new IllegalStateException ("The method getNextTurnNumber () 
should be called once."); 


@Override 

public int getNextTurnNumber () 
this.callsCount++; 
return this.nextTurnNumber; 


{ 


类 似 地 ， 咱 们 可 以 编写 下 一 个 新 特性 TODO 普 通 客户 的 票 号 从 2001 开 始 的 测试 。 运 行 测试 ， 通 过 。 可 以 删除 这 个 TODO 了 。 


新 特性 TODO 普 通 客户 的 票 号 从 2001 开 始 的 代码 如 下 所 示 (CM: Finished TODO: the turn number sequence of the regular customers starts from 2001.) : 


public class TicketDispenserTest { 


// TODO-new-feature: the turn number sequence of the regular customers starts 


from 2001 
+ @Test 
+ public void the turn_number sequence of the regular customers starts from _2001() { 
+ // Arrange — y DA ENE AT y FA 3 w 
+ TurnNumberSequence regularTurnNumberSequence = new TurnNumberSequence (2001) ; 
中 TicketDispenser regularCustomerTicketDispenser = new TicketDispenser 
(regularTurnNumberSequence) ; 
+ 
+ // Bot 
+ TurnTicket ticket = regularCustomerTicketDispenser.getTurnTicket (); 
+ 
+ // Assert 
$ assertEquals (2001, ticket.getTurnNumber () ) ; 
T } 


“我 发 现在 TurnNumberSequence 类 中 ， 成 员 变 量 turnNumber 的 命名 以 下 划 线 开头 ， 不 大 符合 Java 代 码 命名 规范 ， 可 以 把 这 个 下 划 线 去 掉 。” 


去 掉 TurnNumberSequence 类 中 成 员 变 量 turnNumber 的 命名 中 开始 部 分 的 下 划 线 的 代码 如 下 所 示 (CM: Renamed field turnNumber of class TurnNumberSequence to be turnNumber.) 


public class TurnNumberSequence { 
private static int turnNumber = 0; 
private static int turnNumber = 0; 
public TurnNumberSequence (int firstNumber) 
this. turnNumber = firstNumber; 
this.turnNumber = firstNumber; 


+ 


{ 


} 


public int getNextTurnNumber () 
{ 
return _turnNumber++; 
return turnNumbert+; 


“咱们 最 后 写 的 那 两 个 新 特性 的 测试 里 面 ， 分 别 出 现 了 两 次 1001 和 2001 这 两 个 魔法 数 。 一 方 


每 个 数 重复 了 两 遍 ， 另 一 方 


E 


没 错 。 可 以 把 这 两 个 常量 放 到 TurnNumberSequence 类 中 ， 并 且 起 一 个 描述 性 强 的 名 字 。 


消除 1001 和 2001 这 两 个 魔法 数 的 代码 如 下 所 示 (CM: Eliminated magic number code smell for VIP customer first number 1001 and regu 


魔法 数 本 身 不 好 理解 其 意 。 最 好 能 提取 出 一 个 常量 。 


ar customer first number 2001.) : 


public class TurnNumberSequence { 
public static final int REGULAR_CUSTOMER_FIRST NUMBER = 2001; 
public static final int VIP_CUSTOMER_FIRST_NUMBER = 1001; 


Ee 
+ 


public class TicketDispenserTest { 


@Test 
public void the turn number sequence of the vip customers starts from 1001() { 
// Arrange 
TurnNumberSequence vipCustomerTurnNumberSequence 
TurnNumberSequence vipCustomerTurnNumberSequence 
(TurnNumberSequence.VIP CUSTOMER FIRST NUMBER); 


new TurnNumberSequence (1001); 
new TurnNumberSequence 


// Assert 
assertEquals (1001, ticket.getTurnNumber () ) 7 
assertEquals (TurnNumberSequence.VIP CUSTOMER FIRST NUMBER, ticket. 
getTurnNumber () ) 7 = i: 7 
} 
@Test 
public void the turn number sequence of the regular customers starts from _2001() { 
// Arrange — i Be he 本 m k 7 
TurnNumberSequence regularTurnNumberSequence = new TurnNumberSequence (2001) ; 
TurnNumberSequence regularTurnNumberSequence = new TurnNumberSequence 
(TurnNumberSequence . REGULAR_CUSTOMER_FIRST_NUMBER) ; 


// Assert 
assertEquals (2001, ticket.getTurnNumber () ); 


水 assertEquals (TurnNumberSequence.REGULAR_CUSTOMER_FIRST_NUMBER, ticket. 
getTurnNumber () ) ; 


这 个 针对 Mock 和 子 类 化 并 履 写 的 操练 就 可 以 告 一 段落 了 。 


“咱们 前 面 做 的 Mock 操 练 是 手写 Mock。 现 在 有 很 多 有 关 Mock 的 开源 框架 ， 能 方便 地 写 Mock。 要 不 咱们 也 操练 一 下 “ 


当然 可 以 。 咱 们 不 妨 试 试 Mockito。 因 为 咱们 现在 已 经 把 Mock 手 写 完毕 了 ， 为 了 操练 Mockito， 咱 们 需要 执行 一 个 git reset -hard 命 令 ， 来 回 退 到 手写 Mock 之 前 的 代码 版 本 ， 即 刚刚 完成 “新 票 比 另 
一 台 取 号 机 上 出 的 前 一 张 的 票 号 要 大 ”的 TODO 的 代码 版 本 。 然 后 在 这 个 代码 版 本 下 ， 用 git checkout -b 命 令 再 新 创建 一 个 名 为 using-mockito-error-fixing-oriented 分 支 向 ， 这 样 咱们 操练 Mockito 的 代 
码 就 不 会 与 前 面 的 代码 发 生 冲 突 。 


好 了 ， 现 在 已 经 回 退 到 刚刚 完成 “新 票 比 另 一 台 取 号 机 上 出 的 前 一 张 的 票 号 要 大 ”的 TODO 的 代码 版 本 。 然 后 开始 处 理 那 个 单元 测试 “给 取 号 机 11 就 能 打印 出 一 张 号 码 是 11 的 票 ” 的 TODO 了 。 将 其 标 
记 为 working-on， 并 编写 相应 测试 的 Assert 部 分 的 意图 代码 。 这 些 步 骤 和 前 面 是 一 样 的 。 


将 “给 取 号 机 11 就 能 打印 出 一 张 号 码 是 11 的 票 ”的 TODO 标 记 为 working-on， 并 编写 相应 测试 的 Assert 部 分 的 意图 代码 如 下 所 示 (CM: Working on TODO: the class TicketDispenser should 


dispense the ticket number 11 if give a turn number 11 to it.Wrote an assertion for its test.) : 


public class TicketDispenserTest { 


= // TODO-unit-test: the class TicketDispenser should dispense the ticket 
number 11 if give a turn number 11 to it 

+ // TODO-unit-test-working-on: the class TicketDispenser should dispense the 
ticket number 11 if give a turn number 11 to it 

+ @Test 

+ public void the class TicketDispenser should dispense the ticket number 11_ 
if give a turn number 11 to it() { 

+ // Assert | = ER 

assertEquals (11, ticket.getTurnNumber ()); 


接 下 来 就 该 写 这 个 测试 的 Act 和 Arrange 部 分 的 意图 代码 了 。Act 部 分 和 前 面 的 一 样 ，ticket 本 地 变量 是 TurnTicket 类 型 ， 其 值 来 自 取 号 机 对 象 ticketDispenser 的 getTurnTicket () 方法 的 返 
ticketDispenser 本 地 变量 是 TicketDispenser 类 型 ， 其 值 来 自 该 类 new 出 来 的 一 个 对 象 。 


B 
al 


因为 咱们 要 使 用 Mockito， 所 以 接 下 来 的 代码 就 开始 和 以 前 有 些 不 一 样 了 ， 但 是 总 体 思 路 是 一 样 的 。 咱 们 现在 使 用 Mockito 的 编程 意图 ， 来 在 测试 中 编写 意 


代码 ， 并 与 前 面 手写 Mock 的 代码 进行 对 


@ 


比 。 


现在 ， 形 参 为 TurnNumberSequence 的 TicketDispenser 类 的 构造 器 接受 的 mockTurn-NumberSequence 实 参 ， 不 再 是 new 出 来 的 MockTurnNumberSequence 对 象 ， 而 是 从 Mockito 框 架 中 调 
mock (TurnNumberSequence.class) 所 创建 的 Mock 对 象 。 


接 下 来 将 期 望 的 票 号 11 传 进 Mock 对 象 的 方式 ， 不 再 是 让 mockTurnNumberSequence 对 象 调用 它 的 arrangeNextTurnNumber () 方法 ， 而 是 调用 Mockito 框 架 的 when (mock- 
TurnNumberSequence.getNextTurnNumber () ) .thenReturn (11) 方法 来 完成 。 来 将 期 望 的 票 号 11 传 进去 。 


最 后 在 测试 运行 结束 前 ， 验 证 TurnNumberSequence 这 个 接口 中 的 getNextTurnNumber () 方法 被 调用 了 一 次 这 个 验证 SUT 的 间接 输出 的 方式 ， 不 再 是 让 mockTurnNumberSequence 对 象 调 
verifyMethodGetNextTurnNumberCalledOnce () 方法 ， 而 是 调用 Mockito 框 架 的 verify (mockTurnNumberSequence) .getNextTurnNumber () 方法 。 


完成 the_class_ TicketDispenser_should dispense the ticket_number_11_if_give_a turn_number_11_to_it () 测试 方法 的 有 关 Mockito 的 意图 代码 如 下 所 示 (CM: Wrote the intention code for 


the Act, Arrange and Assert parts of the test the_class_ TicketDispenser_ should dispense the ticket number 11 if give a turn number 11 to it () .) : 


public class TicketDispenserTest { 


// TODO-unit-test-working-on: the class TicketDispenser should dispense the 
ticket number 11 if give a turn number 11 to it 

@Test 

public void the class TicketDispenser should dispense the ticket _number 11 
if give a turn number 11 to it() T E iiia ~ oS 


+ // Arrange 
+ TurnNumberSequence mockTurnNumberSequence = mock (TurnNumberSequence.class) ; 
+ when (mockTurnNumberSequence.getNextTurnNumber () ) .thenReturn (11) ; 
+ TicketDispenser ticketDispenser = new TicketDispenser (mockTurnNumberSequence) ; 
+ 
+ // Act 
+ TurnTicket ticket = ticketDispenser.getTurnTicket (); 
+ 
// Assert 
assertEquals (11, ticket.getTurnNumber () ); 
a verify (mockTurnNumberSequence) .getNextTurnNumber () ; 


写 完 测试 的 意图 代码 后 ， 发 现代 码 中 mock、when 和 verify 这 些 方 法 名 都 是 编译 错误 的 红色 。 这 是 因为 Mockito 的 Jar 包 还 没有 通过 Maven 引 入 。 需 要 修改 pom.xml 文 件 ， 并 把 这 些 方法 静态 import 进 
来 。 


在 pom.xml 文 件 中 添加 Mockito 的 依赖 ， 并 在 TicketDispenserTest 类 中 静态 Import 相关 方法 的 代码 如 下 所 示 (CM: Added mockito dependency in the pom.xml and imported related methods 
statically.) : 

<project> 

~ <dependencies> 


<dependency> 
<groupId>org.mockito</groupId> 
<artifactId>mockito-core</artifactId> 
<version>1.9.5</version> 
<scope>test</scope> 
</dependency> 
</dependencies> 
</project> 
+import static org.mockito.Mockito.mock; 
+import static org.mockito.Mockito.verify; 
+import static org.mockito.Mockito.when; 


++++++; 


写 完 上 面 的 代码 ， 在 IDEA 中 单 击 在 右上 角 随即 出 现 的 Import Changes 按 钮 ， 代 码 中 mock、when 和 verify 这 些 方法 名 的 编译 错误 的 红色 就 消失 了 。 现 在 ， 只 剩 下 new 
TicketDispenser (mockTurnNumberSequence) ; 语句 中 mockTurnNumberSequence 下 面 的 红色 下 划 波 浪 线 的 编译 错误 了 。 这 是 由 于 带 有 TurnNumberSequence 类 型 参数 的 TicketDispenser 类 的 构 
造 器 还 未 创建 。 现 在 就 创建 它 。 


创建 带 有 TurnNumberSequence 类 型 参数 的 TicketDispenser 类 的 构造 器 以 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Created constructor 


TicketDispenser (TurnNumberSequence) .) : 


public class TicketDispenser { 
public TicketDispenser (TurnNumberSequence turnNumberSequence) { 


+ } 


按 Ctrl+F5 快 捷 键 运行 测试 ， 有 编译 错误 。 发 现 刚刚 添加 的 带 有 参数 的 TicketDispenser 类 的 构造 器 ， 让 原先 调用 默认 的 TicketDispenser 类 的 构造 器 的 语句 无 法 工作 。 现 在 就 显 式 定义 默认 的 
TicketDispenser 类 的 构造 器 。 


显 式 定 义 默 认 的 TicketDispenser 类 的 构造 器 来 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Created constructor TicketDispenser () .) : 


Public class TicketDispenser { 
a public TicketDispenser() { 


+ 
+ } 


现在 编译 错误 没有 了 ， 按 Ctrl+F5 快 捷 键 运行 测试 。 遇 到 了 MissingMethodlnvocationException， 意 思 是 
说 “when (mockTurnNumberSequence.getNextTurnNumber () ) .thenReturn (11) ; ”这 条 语句 中 ，when () 方法 中 的 参数 必须 是 一 个 能 够 在 Mock 对 象 上 调用 的 方法 。 把 光标 移动 到 
when () 方法 中 的 getNextTurnNumber () 上 ， 按 Ctrl+Alt+G 组 合 键 来 看 这 个 方法 的 定义 ， 看 到 TurnNumberSequence 类 中 的 getNextTurnNumber () 是 一 个 静态 方法 ， 所 以 无 法 被 Mock 对 象 调 
。 现 在 就 把 getNextTurnNumber () 方法 前 面 的 static 修 饰 去 掉 。 


将 TurnNumberSequence 类 中 的 getNextTurnNumber () 方法 改 为 非 静态 的 以 修复 MissingMethodlnvocationException 异 常 的 代码 如 下 所 示 (CM: Fixed 


MissingMethodInvocationException: Made method TurnNumberSequence.getNextTurnNumber () non-static so that mock framework can call it.) : 


public class TurnNumberSequence { 


一 Public static int getNextTurnNumber () 
+ public int getNextTurnNumber () 
{ 


return _turnNumber++; 


} 


按 Ctrl+F5 快 捷 键 运行 测试 。 发 现 编译 错误 ， 原 因 是 刚刚 把 TurnNumberSequence 类 中 的 getNextTurnNumber () 方法 改 为 非 静 态 的 了 ， 所 以 在 TicketDispenser 类 的 getTurnTicket () 方法 中 对 它 
的 调用 就 不 能 是 直接 调用 静态 方法 了 ， 需 要 使 用 turnNumberSequence 这 个 对 象 来 调用 这 个 方法 ， 而 这 个 turnNumberSequence 对 象 需 要 在 TicketDispenser 类 中 创建 TurnNumberSequence 类 型 的 成 员 


ae 
变量 。 


把 在 TicketDispenser 类 的 getTurnTicket () 方法 中 对 TurnNumberSequence 类 中 的 getNextTurnNumber () 方法 的 调用 改 为 非 静态 的 代码 如 下 所 示 (CM: Fixed compiler error: Used an 


object to call a non-static member method.) : 


public class TicketDispenser { 
+ private TurnNumberSequence turnNumberSequence; 


public TurnTicket getTurnTicket () 


// TODO: Depending on a static method violates the Dependency Inversion 
Principle and Open-Closed Principle. 
= int newTurnNumber = TurnNumberSequence .getNextTurnNumber () 7 
+ int newTurnNumber = turnNumberSequence.getNextTurnNumber () ; 


再 次 运行 测试 ， 在 TicketDispenser 类 的 getTurnTicket () 方法 中 的 turnNumberSequence.getNextTurnNumber () 语句 中 发 现 了 空 指针 异常 。 这 是 由 于 咱们 的 
TicketDispenser (TurnNumberSequence) 构造 器 是 空 的 ， 还 未 保存 从 参数 传 进 的 turnNumberSequence。 现 在 就 修复 它 。 


实现 TicketDispenser (TurnNumberSequence) 构造 器 以 修复 空 指针 异常 的 代码 如 下 所 示 (CM: Fixed null pointer exception: Implemented constructor 


TicketDispenser (TurnNumberSequence) .) : 


public class TicketDispenser { 

private TurnNumberSequence turnNumberSequence; 

public TicketDispenser (TurnNumberSequence turnNumberSequence) { 
+ this.turnNumberSequence = turnNumberSequence; 

} 


运行 测试 。 “给 取 号 机 11 就 能 打印 出 一 张 号 码 是 11 的 票 ” 的 TODO 的 测试 运行 通过 了 。 前 面 两 个 新 票 票 号 比 前 一 张 票 号 大 1 的 测试 抛 出 空 指 针 异 常 ， 抛 出 异常 的 语句 和 前 面 是 一 样 的 。 这 是 因为 
TicketDispenser 的 默认 构造 器 还 未 实现 ， 需 要 从 这 个 默认 构造 器 中 调用 那个 带 参数 的 构造 器 ， 并 传递 一 个 新 new 出 来 的 TurnNumberSequence 对 象 。 


实现 TicketDispenser () 默认 构造 器 以 修复 空 指针 异常 的 代码 如 下 所 示 (CM: Fixed null pointer exception: Implemented constructor TicketDispenser () .) : 


Public class TicketDispenser { 
public TicketDispenser() { 


+ this (new TurnNumberSequence () ) ; 
} 


运行 测试 ， 通 过 。 这 样 ， 这 个 有 关 Meockito 的 操练 中 关于 依赖 静态 方法 的 TODO 和 “给 取 号 机 11 就 能 出 一 张 号 码 是 11 的 票 ”的 TODO 都 完成 了 。 可 以 把 它们 删除 。 


至 此 ， 这 个 有 关 自 动 取 号 系统 的 编程 操练 就 告 一 段落 。 为 了 便于 和 重 构 前 的 代码 进行 比较 ， 下 面 列 出 重 构 后 的 测试 代码 和 生产 代码 D]。 


GS 


手写 Mock 的 TicketDispenserTest 类 在 重 构 后 的 代码 如 下 所 示 : 


public class TicketDispenserTest { 
@Test 
public void a new ticket_should have the turn_number subsequent to the 
previous ticket() {7 ~ _~ ~ 本 0 
// Arrange 
TicketDispenser ticketDispenser = new TicketDispenser (); 
TurnTicket previousTicket = ticketDispenser.getTurnTicket () ; 


// Act 

TurnTicket newTicket = ticketDispenser.getTurnTicket () ; 

// Assert 

assertEquals (1, newTicket.getTurnNumber() - previousTicket.getTurnNumber () ) 7 


} 
@Test 


public void a new ticket should have the turn number subsequent to the 
previous ticket from another dispenser() {T ASO 
// Arrange a a zs 
TicketDispenser anotherTicketDispenser = new TicketDispenser () ; 
TicketDispenser ticketDispenser = new TicketDispenser (); 
// Bet 
TurnTicket previousTicket = anotherTicketDispenser.getTurnTicket () ; 
TurnTicket newTicket = ticketDispenser.getTurnTicket () ; 
// Assert 
assertEquals (1, newTicket.getTurnNumber() - previousTicket.getTurnNumber () ) 7 
} 
@Test 
public void the class TicketDispenser should dispense the ticket number 11 
if give a turn number 11 to it() T > 7 = 
// Arrange 
MockTurnNumberSequence mockTurnNumberSequence = new MockTurnNumberSequence () ; 
mockTurnNumberSequence.arrangeNextTurnNumber (11) ; 
TicketDispenser ticketDispenser = new TicketDispenser (mockTurnNumberSequence) ; 
// Bet 
TurnTicket ticket = ticketDispenser.getTurnTicket () ; 
// Assert 
assertEquals (11, ticket.getTurnNumber () ); 
mockTurnNumberSequence. verifyMethodGetNextTurnNumberCalledOnce () ; 
} 
@Test 
public void the turn number sequence of the vip customers starts from _1001() { 
// Arrange ~ a + PL ie a is p 
TurnNumberSequence vipCustomerTurnNumberSequence = new TurnNumberSequence 
(TurnNumberSequence.VIP_CUSTOMER_FIRST_NUMBER) ; 
TicketDispenser vipCustomerTicketDispenser = new TicketDispenser 
(vipCustomerTurnNumberSequence) ; 


// Bet 
TurnTicket ticket = vipCustomerTicketDispenser.getTurnTicket () ; 
// Assert 
assertEquals (TurnNumberSequence.VIP_CUSTOMER_FIRST_NUMBER, ticket. 
getTurnNumber () ) ; 
} 
@Test 
public void the turn number sequence of the regular customers starts from 2001() { 
// Arrange 


TurnNumberSequence regularTurnNumberSequence = new TurnNumberSequence 
(TurnNumberSequence.REGULAR_CUSTOMER FIRST NUMBER); 

TicketDispenser regularCustomerTicketDispenser = new TicketDispenser 
(regularTurnNumberSequence) ; 


// Bot 

TurnTicket ticket = regularCustomerTicketDispenser.getTurnTicket () ; 

// Assert 

assertEquals (TurnNumberSequence.REGULAR_CUSTOMER_FIRST_NUMBER, ticket. 
getTurnNumber () ) 7 


使 用 Mockito 编 写 Mock 的 TicketDispenserTest 类 在 重 构 后 的 代码 如 下 所 示 : 


public class TicketDispenserTest { 


@Test 
public void the_class_TicketDispenser_should_dispense_the_ticket_number_11_ 
if give a turn number 11 to it() { 
// Arrange z A es 
TurnNumberSequence mockTurnNumberSequence = mock (TurnNumberSequence.class) ; 
when (mockTurnNumberSequence.getNextTurnNumber () ) .thenReturn (11) ; 
TicketDispenser ticketDispenser = new TicketDispenser (mockTurnNumberSequence) ; 
// Bet 
TurnTicket ticket = ticketDispenser.getTurnTicket () ; 
// Assert 
assertEquals (11, ticket.getTurnNumber () ) ; 
verify (mockTurnNumberSequence) .getNextTurnNumber () ; 


// TODO-new-feature: the turn number sequence of the vip customers starts 
from 1001 

// TODO-new-feature: the turn number sequence of the regular customers 
starts from 2001 


构 后 的 TurnNumberSequence 的 代码 如 下 所 示 : 


public class TurnNumberSequence { 
public static final int REGULAR_CUSTOMER_FIRST NUMBER = 2001; 
public static final int VIP_CUSTOMER FIRST NUMBER = 1001; 
private static int turnNumber = 0; ` T 
public TurnNumberSequence (int firstNumber) { 
this.turnNumber = firstNumber; 


} 

public TurnNumberSequence() { 
this(0); 

} 

public int getNextTurnNumber () 

{ 
return turnNumber++; 

} 


构 后 的 MockTurnNumberSequence 类 的 代码 如 下 所 示 : 


public class MockTurnNumberSequence extends TurnNumberSequence { 
private int nextTurnNumber; 
private int callsCount = 0; 
public void arrangeNextTurnNumber (int nextTurnNumber) { 
this.nextTurnNumber = nextTurnNumber; 
} 
public void verifyMethodGetNextTurnNumberCalledOnce() { 
if (this.callsCount != 1) { 
throw new IllegalStateException ("The method getNextTurnNumber () 
should be called once."); 
} 
} 
@Override 
public int getNextTurnNumber() { 
this.callsCount++; 
return this.nextTurnNumber; 


构 后 的 TicketDispenser 类 的 代码 如 下 所 示 : 


public class TicketDispenser { 
private TurnNumberSequence turnNumberSequence; 
public TicketDispenser (TurnNumberSequence turnNumberSequence) { 
this.turnNumberSequence = turnNumberSequence; 


} 
public TicketDispenser() { 
this (new TurnNumberSequence () ) ; 
} 
public TurnTicket getTurnTicket () 


int newTurnNumber = turnNumberSequence.getNextTurnNumber () ; 
TurnTicket newTurnTicket = new TurnTicket (newTurnNumber) ; 
return newTurnTicket; 


在 操练 了 Mock 编 写 和 子 类 化 并 履 写 的 编写 单元 测试 的 方法 后 ， 咱 们 可 以 最 后 再 做 一 个 有 关 如 何 针 对 涉及 文件 系统 操作 和 使 用 第 三 方 类 库 进行 单元 测试 的 操练 题目 ， 因 为 这 两 个 问题 在 编程 中 很 常见 。 
不 过 在 继续 操练 前 ， 咱 们 看 看 这 个 操练 都 做 了 哪些 工作 。 


1) 阅读 自动 取 号 系统 的 源 代 码 ， 包 含 TurnTicket 类 、TurnNumberSequence 类 和 Ticket-Dispenser 类 。 


2) 记录 了 调用 静态 方法 从 而 违反 依赖 倒置 和 开 闭 原则 的 TODO。 


3) 记录 了 两 个 新 特性 的 TODO。 


4) 记录 了 两 个 用 户 意 图 测试 的 TODO。 


5) 记录 了 一 个 单元 测试 的 TODO。 


a 


先 写 了 测试 的 Assert 部 分 的 意图 代码 ， 然 后 再 推导 出 Act 和 Arrange 部 分 的 测试 意图 代码 ， 并 通过 修复 意 


IRI 


代码 的 编译 和 测试 运行 错误 ， 来 驱动 出 生产 代码 ， 从 易 到 难 地 完成 上 述 TODO。 


7) 使 用 子 类 化 并 覆 写 的 方法 ， 把 DOC 就 当成 接口 ， 让 SUT 根 据 DOC 这 个 接口 编程 ， 然 后 编写 DOC 这 个 接口 一 个 子 类 ， 并 把 该 子 类 当成 易于 控制 的 Mock， 且 在 这 个 Mock 子 类 中 覆 写 其 DOC 父 类 中 难 
以 在 测试 中 控制 的 方法 ， 最 后 用 这 个 子 类 来 蔡 代 这 个 难以 控制 的 DOC 父 类 。 


8) 在 手工 编写 Mock 完 成 单元 测试 后 ， 又 使 用 了 Mockito 这 个 Mock 开 源 框架 来 编写 Mock。 


9) 通过 操练 我 们 学 到 了 以 下 技能 : 


a) 一 个 在 面向 对 象 编程 语言 中 所 定义 的 具体 的 类 ， 虽 然 在 形式 上 不 是 一 个 接口 ， 但 如 果 该 类 有 一 个 符合 里 氏 蔡 换 原则 的 子 类 ， 那 么 在 子 类 眼中 ， 父 类 就 可 以 被 当成 接口 来 使 用 。 


b) Mock 除 了 完成 Stub 所 做 的 为 SUT 在 测试 中 的 运行 提供 间接 输入 外 ， 还 要 额外 做 验证 SUT 在 测试 中 的 间接 输出 的 事情 ， 所 以 Mock 类 中 一 般 都 有 verify () 这 样 的 验证 方法 。 


c) 使 用 先 编写 意图 代码 ， 然 后 通过 频繁 运行 测试 ， 编 写 最 少量 的 代码 (如 能 让 编译 通过 的 尚未 实现 的 空 方 法 ， 和 能 让 测试 运行 通过 的 上 述 空 方法 的 最 少量 的 实现 代码 ) 以 修复 编译 和 测试 运行 错误 ， 来 
驱动 出 生产 代码 的 开发 方式 ， 既 能 让 我 们 在 编写 意图 代码 时 进行 适当 的 设计 ， 并 能 编写 最 少量 的 能 让 测试 运行 通过 的 生产 代码 ， 以 减少 浪费 ， 又 能 让 我 们 逐步 熟悉 从 各 种 编译 和 测试 运行 的 错误 信息 中 发 现 
导致 错误 的 原因 ， 从 而 不 再 惧怕 看 到 错误 信息 ， 并 把 这 些 信息 当成 指 路 的 向 导 ， 避 免 言 目 地 编写 生产 代码 。 


d) 与 手工 编写 Mock 相 比 ， 用 Mockito 框 架 编 写 Mock 有 下 列 好 处 ， 不 必 编 写 额 外 的 Mock 类 ， 减 少 工作 量 ; 凭借 Mockito 框 架 的 诸如 mock () 、when () 和 verify () 这 些 方法 的 精心 设计 ， 能 够 让 
Meock 代 码 可 读 性 更 高 。 


e) 与 用 Mockito 框 架 编写 Mock 相 比 ， 手 工 编写 Mock 也 有 下 列 好 处 ， 能 够 完全 控制 Mock 的 编写 过 程 ; 熟悉 手工 编写 Mock 的 过 程 后 ， 有 利于 理解 Mock 框 架 的 使 用 方法 。 


1 JX A ThoughtWorks Studio 的 培训 师 和 教练 Luca Minudel 在 2012 年 设计 并 上 传 到 GitHub 上 的 编程 操练 系列 题目 TDD with Mock Objects， 参 见 : 
https: //github.com/lucaminudel/TDDwithMockObjectsAndDesignPrin ciples. 

2 Ticket Dispenser 操 练 题目 原 有 代码 参见 : https://github.com/wubin28/tbe-ticket-dispenser-java/tree/exercise; 本 书 针对 该 题目 的 操练 步骤 代码 参见 : https://github.com/wubin28/tbc-ticket-dispenser- 
java/ tree/subclass-and-override-method。 

3] 里 氏 替 换 原 则 指 的 是 ， 子 类 型 必须 能 够 替换 掉 它 们 的 基 类 型 ， 使 得 替换 后 程序 行为 不 变 。 参 见 Robert C.Martin 所 著 《 敏 捷 软 件 开 发 : 原则 、 模 式 与 实践 》 一 书 。 

4] 针对 Mockito 的 操练 代码 参见 : https://github.com/wubin28/tbc-ticket-dispenser-java/tree/using-mockito-errorfixing-orientedo 

5] TurnTicket 类 在 重 构 中 未 发 生变 化 ， 故 略 去 。 


第 18 章 ”真正 的 单元 测试 


现在 中 国人 出 国旅 游 ， 要 买点 称心 的 纪念 品 带 回来 ， 难 度 可 比 以 前 大 多 了 。 


“可 不 是 ! 我 的 一 个 球迷 朋友 前 一 阵 刚刚 参加 完 世 界 杯 旅游 ， 从 巴西 回来 。 他 跟 我 说 ， 无 论 是 在 里 约 热 内 卢 的 世界 杯 纪念 品 官方 旗舰 店 里 ， 还 是 街头 的 小 贩 手 里 ， 像 吉祥 物 “福来 哥 ' 、 球 队 队 服 、 球 
迷 围 巾 这 些 抢手 的 纪念 品 ， 后 面 都 印 着 Made in China 或 Fabricado na Chinall]。 搞 得 他 一 直 在 纠结 是 不 是 该 把 这 些 中 国 造 的 东西 再 干 里 巡 志 地 背 回 国 去 。” 


是 呀 ， 要 买 这 些 纪念 品 ， 最 经 济 快捷 的 办 法 是 上 淘宝 ， 足 不 出 户 就 能 搞定 。 


与 人 们 用 是 否 经 济 快捷 的 标准 来 衡量 购买 世界 杯 纪念 品 是 值 还 是 不 值 相似 ， 测 试 也 可 以 根据 是 否 经 济 快捷 这 一 点 ， 来 划分 为 真正 的 单元 测试 和 非 单 元 测试 。Michael C.Feathers 和 干脆 把 经 济 快捷 这 一 点 
浓缩 为 一 个 字 : “ 快 ”。 


单元 测试 运行 得 快 。 运 行 得 不 快 的 不 是 单元 测试 。 一 个 需要 耗 时 0.1 秒 才能 执行 完 的 单元 测试 就 已 算是 一 个 慢 的 单元 测试 了 。 
有 些 测试 容易 跟 单元 测试 混 清 起 来 。 比 如 下 面 这 些 测试 就 不 是 单元 测试 ; 

1) 跟 数据 库 有 
2) 进行 了 网 络 间 的 通信 ; 

3) 调用 了 文件 系统 ; 

4) 需要 对 环境 做 特定 的 准备 (如 编辑 配置 文件 ) 才能 运行 起 来 。 [1] 


[1]Michael C.Feathers 著 ， 刘 未 鹏 译 ，《 修 改 代码 的 艺术 》， 人 民 邮 电 出 版 社 ，2007 年 11 月 第 1 版 ， 第 12 页 。 


“ 哦 ， 这 样 看 起 来 我 以 前 曾经 写 过 的 涉及 文件 系统 和 数据 库 的 测试 ， 都 不 能 算 单元 测试 ， 而 只 能 算 集成 测试 了 。 那 么 如 何 才能 把 这 些 集成 测试 转变 为 单元 测试 呢 ?” 


单元 测试 要 测 的 仅仅 是 SUT 里 面 的 软件 行为 ， 而 不 是 测试 SUT 与 诸如 数据 库 、 网 络 和 文件 系统 这 些 DOC 之 间 是 否 能 正常 交互 。 可 以 先 找到 DOC 的 接口 ， 然 后 让 SUT 针 对 这 个 接口 编程 ， 并 且 编 写 一 个 运 
行 起 来 经 济 快捷 的 Test Double 来 实现 这 个 接口 ， 并 注入 SUT 中 ， 让 SUT 把 这 个 Test Double 当 成 那个 接口 来 使 用 。 这 样 就 能 把 依赖 于 DOC 的 集成 测试 ， 转 换 为 依赖 于 实现 接口 的 Test Double 的 单元 测试 
了 。 


咱们 现在 就 做 一 个 和 文件 系统 相关 的 编程 题目 ， 来 操练 一 下 。 这 个 题目 是 网 页 文本 转换 系统 外， 只 有 一 个 类 UnicodeFileToHtmlTextConverter， 用 来 将 一 个 Unicode 的 纯 文本 文件 转换 为 HTML 编 码 
(HTML-encoded) 格式 的 文件 。 这 个 操练 要 求 在 为 这 个 类 编写 单元 测试 的 基础 上 ， 实 现 一 个 新 特性 : 能 够 将 一 个 Unicode 的 纯 文本 字符 串 转换 为 HTML 编 码 格式 的 字符 串 。 


在 这 个 题目 中 ， 网 页 文本 转换 系统 是 SUT， 转 换 前 用 的 有 关 文 件 的 FileReader 对 象 就 是 DOC。 根 据 前 面 的 讨论 ， 与 文件 发 生 交互 的 测试 不 是 单元 测试 。 要 编写 单元 测试 ， 可 以 从 DOC 提 取 一 个 接口 ， 即 
可 以 利用 现成 的 Java 语 言 的 Reader 抽 象 类 ， 让 SUT 针 对 Reader 编 程 ， 而 不 再 针对 FileReader 具 体 实现 编程 。 新 特性 要 实现 字符 串 的 网 页 文本 转换 ， 所 以 就 可 以 使 用 有 关 字符 串 的、 实现 了 Reader 接 口 的 
StringReader 对 象 ， 来 充当 Test Double 注 入 SUT 中 ， 来 进行 单元 测试 。 


看 一 下 代码 BJ。 代码 有 两 个 类 。 第 一 个 类 是 UnicodeFileToHtmlTextConverter， 它 有 两 个 公共 接口 方法 ， 一 个 是 带 有 字符 串 类 型 的 构造 器 ， 用 来 保存 文件 完整 的 路 径 ; 另 一 个 是 convertToHtml () 
方法 ， 用 来 读 取 文件 ， 并 把 文件 中 的 Unicode 文 本 内 容 转 换 为 HTML 编 码 格式 的 文本 内 容 ， 最 后 将 转换 后 的 字符 串 返回 。 


UnicodeFileToHtmlTextConverter 类 的 代码 如 下 所 示 : 


public class UnicodeFileToHtmlTextConverter { 
private String fullFilenameWithPath; 
public UnicodeFileToHtmlTextConverter (String fullFilenameWithPath) 


this. fullFilenameWithPath = fullFilenameWithPath; 
} 
public String convertToHtml() throws IOException{ 
BufferedReader reader = new BufferedReader (new FileReader (fullFilenameWithPath) ) ; 
String line = reader.readLine(); 
String html = ""; 
while (line != null) 
{ 
html += StringEscapeUtils.escapeHtml (line) ; 
html += "<br />"; 
line = reader.readLine(); 
} 
return html; 


另 一 个 类 UnicodeFileToHtmlTextConverterTest 是 一 个 测试 类 ， 里 面 只 有 一 个 测试 2+3=5 的 这 个 必然 通过 的 测试 ， 用 来 验证 单元 测试 框架 JUnit 是 否 能 正常 工作 。 把 光标 移动 到 这 个 测试 类 名 上 ， 然 后 
按 Ctrl+Shift+F10 组 合 键 ， 运 行 一 下 这 个 测试 。 通 过 。 


还 是 像 以 前 一 样 ， 先 读 一 读 代 码 ， 看 看 有 没有 什么 严重 的 代码 “ 腐 臭 ”。 


“和 前 面 两 个 题目 类 似 ， 在 convertToHtml () 方法 里 面 的 语句 ‘BufferedReader reader=new BufferedReader (new FileReader (fullFilenameWithPath) ) ; © ， 也 是 依赖 于 一 个 new 出 来 的 
FileReader 的 具体 实现 ， 而 不 是 依赖 于 接口 编程 ， 这 违反 了 依赖 倒置 和 开 闭 原则 。 写 个 TODO 记 下 来 吧 。” 


添加 依赖 于 FileReader 的 具体 实现 的 TODO 的 代码 如 下 所 示 (CM: Added TODO: Depending on the file system violates the Dependency Inversion Principle and Open-Closed Principle.) : 


public class UnicodeFileToHtmlTextConverter { 


public String convertToHtml() throws IOException{ 
+ // TODO: Depending on the file system violates the Dependency Inversion 
Principle and Open-Closed Principle 
BufferedReader reader = new BufferedReader (new FileReader (fullFilenameWithPath) ) ; 


“Bb,  ‘StringEscapeUtils.escapeHtml (line) ; ”这 条 语句 直接 使 用 了 第 三 方 类 库 ， 这 也 是 一 种 不 明智 的 行为 。 因 为 当 程 序 中 遍布 对 这 个 第 三 方 类 库 的 直接 调用 时 ， 一 旦 该 类 库 有 问题 需要 更 换 ， 
就 会 带 来 很 大 的 工作 量 。 这 也 违反 了 依赖 倒置 和 开 闭 原则 。” 


对 。 比 较 好 的 做 法 是 在 第 三 方 类 库 的 外 面 外 覆 一 个 类 ， 然 后 让 咱们 的 生产 代码 针对 这 个 外 覆 类 的 接口 编程 ， 而 让 第 三 方 类 库 在 这 个 外 履 类 中 实现 这 些 接口 。 可 以 写 一 个 有 关 直接 依赖 第 三 方 类 库 的 
TODO。 


在 convertToHtml () 方法 中 添加 直接 依赖 第 三 方 类 库 的 TODO 的 代码 如 下 所 示 (CM: Added TODO: Depending on the third party library violates the Dependency Inversion Principle and 
Open-Closed Principle.) : 


public class UnicodeFileToHtmlTextConverter { 
T while (line != null) 
{ 
+ // TODO: Depending on the third party library violates the Dependency 


Inversion Principle and Open-Closed Principle 
html += StringEscapeUtils.escapeHtml (line) ; 


下 面 可 以 把 咱们 要 完成 的 新 特性 写成 一 个 TODO。 


在 测试 类 中 添加 新 特性 “能 够 将 一 个 Unicode 的 纯 文本 字符 串 转换 为 HTML 编 码 格式 的 字符 串 ” 的 TODO 的 代码 如 下 所 示 (CM: Added TODO-new-feature: Make the 


UnicodeFileToHtmlTextConverter working for not only a file but also a string.) : 


public class UnicodeFileToHtmlTextConverterTest { 


+ // TODO-new-feature: Make the UnicodeFileToHtmlTextConverter working for not 
only a file but also a string 


} 


R] 


“能 想到 有 什么 典型 的 有 关 HTML 编 码 转 换 的 用 户 意图 测试 吗 ?“ 


可 以 考虑 转换 “& 字 符 ”、 大 于 号 与 小 于 号 和 行 分 隔 符 这 3 种 情况 ， 可 以 分 别 写 3 个 用 户 意图 TODO。 


在 测试 类 中 添加 转换 “& 字 符 ”、 大 于 号 与 小 于 号 和 行 分 隔 符 这 3 个 用 户 意图 TODO 的 代码 如 下 所 示 (CM: Added 3 user intent test TODOs.) : 


public class UnicodeFileToHtmlTextConverterTest { 


// TODO-new-feature: Make the method convertToHtml() working for not only a 
file but also a string 


// ToDO-user-intent-test: should convert ampersand 
TODO-user-intent-test: should convert greater than and less than 
// TODO-user-intent-test: should add a line break for a new line 


十 十 十 十 
~ 
~ 


先 处 理 转换 “& ”字符 的 TODO， 需 要 调用 一 个 名 为 converter 的 转换 器 对 象 的 convert-ToHtml () 方法 。 


在 测试 类 中 将 转换 “&” 字符 的 TODO 标 记 为 working-on， 并 编写 相应 测试 的 Assert 部 分 的 代码 如 下 所 示 (CM: Working on TODO: should convert ampersand.Wrote test 


should convert ampersand () for it with the Assert part.) : 


public class UnicodeFileToHtmlTextConverterTest { 


+ // TODO-user-intent-test-working-on: should convert ampersand 
@Test 

+ public void should_convert_ampersand() { 

+ // Assert 

+ assertEquals("", converter.convertToHtml () ) 


“怎么 在 上 面 这 个 assertEquals () 方法 中 的 第 一 个 参数 是 空 字符 ? 这 应 该 是 期 望 的 字符 串 呀 。” 


对 ， 这 是 有 意 这 样 写 的 。 这 里 要 运用 前 面 咱们 谈 到 过 的 特征 测试 。 即 可 以 故意 在 测试 的 断言 中 填写 一 个 不 正确 的 期 望 结果 ， 然 后 让 测试 运行 到 这 里 。 一 般 测试 到 这 里 会 运行 出 错 ， 并 在 出 错 信息 中 给 出 
实际 值 。 此 时 可 以 把 出 错 信息 中 的 实际 值 ， 填 写 到 测试 断言 中 的 期 望 值 那 里 ， 来 让 测试 运行 通过 。 


“不 错 。 这 种 方法 尤其 适用 于 不 了 解 SUT 的 实际 行为 的 测试 。” 


接着 写 这 个 测试 的 Act 和 Arrange 部 分 的 意图 代码 。Act 部 分 其 实 和 Assert 部 分 是 合 在 一 起 的 。 在 Arrange 部 分 中 ， 名 为 converter 的 转换 器 对 象 应 该 来 自 一 个 new 出 来 的 
UnicodeFileToHtmlITextConverter 对 象 。 我 希望 在 new 这 个 对 象 的 时 候 ，UnicodeFile-ToHtml-TextConverter 类 的 构造 器 能 够 接受 一 个 StringReader 对 象 ， 而 这 个 StringReader 对 象 在 new 的 时 候 被 传 
A "H&M" 这样 一 个 字符 串 。 


“为 什么 要 这 样 写意 图 代码 呢 ?” 


其 实 我 是 想 让 上 面 那个 UnicodeFileToHtmlITextConverter 类 的 构造 器 ， 能 够 针对 Reader 内 这 个 抽象 来 编程 。 上 面 那 个 StringReader 是 Reader 的 子 类 ， 而 咱们 这 个 题目 的 
UnicodeFileToHtmlTextConverter 类 原先 所 依赖 的 FileReader， 是 InputStreamReader 类 的 子 类 ， 而 InputStreamReader 类 又 是 Reader 类 的 子 类 。 所 以 这 个 参数 类 型 为 Reader 的 Unicode- 
FileToHtmlITextConverter 构 造 器 ， 既 能 接受 这 个 题目 的 新 特性 所 要 求 的 StringReader 类 型 的 对 象 ， 又 能 接受 原 有 的 FileReader 类 型 的 对 象 。 


完成 测试 should_convert ampersand () 的 Act 和 Arrange 部 分 的 意图 代码 的 代码 如 下 所 示 (CM: Finished the intention code of test should_convert_ampersand () .) : 


public class UnicodeFileToHtmlTextConverterTest { 


// TODO-user-intent-test-working-on: should convert ampersand 


@Test 
public void should convert _ampersand() { 
= // Assert 3 T 
+ // Arrange 
+ UnicodeFileToHtmlTextConverter converter = new UnicodeFileToHtmlTextConverter 


(new StringReader ("H&M") ) 7 


++ 


// Act & Assert 
assertEquals("", converter.convertToHtml ()); 


“ 写 完 意图 代码 后 ， ‘new UnicodeFileToHtmlTextConverter (new StringReader ("H&M") ) ; ”语句 中 的 new StringReader ("H&M") 下 方 出现 了 表示 编译 错误 的 红色 下 划 波 浪 线 。 这 是 
为 还 未 创建 带 有 Reader 类 型 参数 的 UnicodeFileToHtmlTextConverter 构 造 器 。 现 在 就 创建 。” 


加 


创建 带 有 Reader 类 型 参数 的 UnicodeFileToHtmlTextConverter 构 造 器 以 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Created constructor UnicodeFileToHtmlTextConverter 
(Reader) .) : 


public class UnicodeFileToHtmlTextConverter { 
+ public UnicodeFileToHtmlTextConverter (Reader reader) { 
+ 


+ } 


“修复 了 上 面 那个 编译 错误 ， 接 下 来 看 converter.convertToHtml () 语句 的 红色 编译 错误 。 查 看 错误 信息 ， 发 现 是 没有 处 理 IOException。 按 Alt+ Enter 快 捷 键 在 测试 方法 的 签名 中 添加 抛 出 异常 的 语 
Bly 


在 测试 方法 should_convert_ ampersand () 的 签名 中 添加 抛 出 异常 的 语句 以 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Added Exception to method signature.) : 


public class UnicodeFileToHtmlTextConverterTest { 


// TODO-user-intent-test-working-on: should convert ampersand 


@Test 
= public void should_convert_ampersand() { 
+ public void should_convert_ampersand() throws IOException { 


“编译 错误 没有 了 。 现 在 可 以 按 Ctrl+F5 快 捷 键 运行 测试 。 在 ‘new BufferedReader (new FileReader (fullFilenameWithPath) ) ; ′ 语句 中 出 现 了 空 指针 异常 ， 原 因 是 测试 中 没有 给 full- 
FilenameWithPath 赋 值 ， 所 以 它 是 空 指针 。 解 决 的 办 法 可 以 是 让 这 行 代码 针对 Reader 这 个 抽象 编程 ， 而 不 是 针对 new 出 来 的 FileReader 对 象 这 个 具体 实现 来 编程 。 也 就 是 现在 可 以 处 理 那 个 依赖 文件 系统 
的 TODO， 把 这 个 TODO 标 记 为 working-on。” 


接 下 来 就 可 以 根据 刚刚 说 到 的 意图 , 把 “new BufferedReader (new FileReader (fullFilename-WithPath) ) ; ” 改 为 “new BufferedReader (this.reader) ; ”， 也 就 是 说 希望 
UnicodeFileToHtml-TextConverter 类 有 一 个 名 为 reader 的 成 员 变 量 ， 并 把 这 个 成 员 变 量 所 保存 的 Reader 对 象 值 传递 到 BufferedReader 构 造 器 中 。 


在 convertToHtml () 方法 中 编写 意图 代码 来 让 其 依赖 Reader 这 个 抽象 以 修复 空 指针 异常 的 代码 如 下 所 示 (CM: Fixing null pointer exception: Wrote intention code in method Unicode- 


FileToHtmlTextConverter.convertToHtml () to depend on the interface Reader instead of a concrete FileReader object.) : 


public class UnicodeFileToHtmlTextConverter { 


public String convertToHtml() throws IOException{ 
// TODO-working-on: Depending on the file system violates the Dependency 
Inversion Principle and Open-Closed Principle 
一 BufferedReader reader = new BufferedReader (new FileReader (fullFilenameWithPath) ) ; 
+ BufferedReader reader = new BufferedReader (this. reader) ; 


“ 写 完 意 图 代码 后 ， 在 this.reader 中 的 reader 成 为 有 编译 错误 的 红色 。 原 因 是 reader 这 个 成 员 变 量 尚 未 创建 ， 现 在 就 创建 它 。” 


创建 类 型 为 Reader 的 成 员 变 量 reader 以 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Created a Reader field in class UnicodeFileToHtmlTextConverter.) : 


public class UnicodeFileToHtmlTextConverter { 
private String fullFilenameWithPath; 
+ private Reader reader; 


“没有 编译 错误 了 ， 再 次 运行 测试 ， 还 是 在 同样 位 置 出 现 的 空 指针 异常 。 这 是 


为 咱们 在 测试 中 通过 带 有 Reader 类 型 参数 的 UnicodeFileToHtmlTextConverter 构 造 器 所 传 进来 的 reader 尚 未 被 保存 并 


传递 到 空 指针 异常 的 语句 中 。 现 在 就 修复 这 个 异常 。” 


实现 构造 器 UnicodeFileToHtmlTextConverter (Reader) 以 修复 空 指 针 异 常 


的 代码 如 下 所 示 (CM: Fixed null pointer exception: Implemented constructor 


UnicodeFileToHtmITextConverter (Reader) .) : 


publi 


“运行 测试 ， 发 现 了 比较 失败 ComparisonFailure， 期 望 的 是 空 串 ， 但 实际 值 是 “H&amp; M<br/>' ， 可 以 把 这 个 实际 值 复制 到 测试 的 assertEquals () EWE 


c class UnicodeFileToHtmlTextConverter { 


public UnicodeFileToHtmlTextConverter (Reader reader) 
this.reader = reader; 


{ 
} 


运行 测试 ， 通 过 。” 


对 。 


修改 
keep the 


Publ 


c EE AE E 


original function for FileReader working.) : 


ic class UnicodeFileToHtmlTextConverter { 
private String fullFilenameWithPath; 
private Reader reader; 
public UnicodeFileToHtmlTextConverter (String fullFilenameWithPath) 
{ 
this.fullFilenameWithPath = fullFilenameWithPath; 


public UnicodeFileToHtmlTextConverter (String fullFilenameWithPath) 
throws FileNotFoundException { 
oh this.reader = new FileReader (fullFilenameWithPath) ; 
} 
“运行 测试 ， 通 过 。 这 样 ， 咱 们 就 完成 了 依赖 文件 系统 的 TODO 和 转换 “&” 字 符 的 TODO， 可 以 把 它们 删除 。” 


有 了 这 个 测试 作为 基础 ， 就 能 很 容易 地 编写 出 针对 转换 大 于 号 与 小 于 号 和 行 分 隔 符 这 两 个 


TODO 的 测试 。 


[ 


完成 转换 大 于 号 与 小 于 号 的 


TODO 的 测试 代码 如 下 所 示 (CM: Finished TODO: should convert greater than and less than.) : 


public class UnicodeFileToHtmlTextConverterTest { 

= // TODO-user-intent-test: should convert greater than and less than 

+ QTest 

+ public void should_convert_greater_than_and_less_than() throws IOException { 

+ // Arrange 

fe UnicodeFileToHtmlTextConverter converter = new UnicodeFileToHtmlTextConverter 
(new StringReader ("> <|]1")); 

+ 

+ // Act & Assert 

+ assertEquals ("&gt;_&1t;|||<br />", converter.convertToHtml () ) ; 

+ } 

运行 测试 ， 通 过 。 

完成 转换 行 分 隔 符 的 用 户 意图 TODO 的 测试 代码 如 下 所 示 (CM: Finished TODO: should add a line break for a new line.) : 

public class UnicodeFileToHtmlTextConverterTest { 

= // TODO-user-intent-test: should add a line break for a new line 

+ @Test 

+ public void should add a line break for a new line() throws IOException { 

+ // Arrange 

+ UnicodeFileToHtmlTextConverter converter = new UnicodeFileToHtmlTextConverter 
(new StringReader ("Cheers\nBen Wu")); 

+ 

+ // Act & Assert 

中 assertEquals ("Cheers<br />Ben Wu<br />", converter.convertToHtml ()); 

et } 

运行 测试 ， 通 过 。 因 为 咱们 现在 已 经 实现 了 将 字符 串 转换 为 HTML 编 码 的 格式 ， 所 以 也 完成 了 那个 新 特性 的 TODO， 可 以 删 掉 该 TODO。 


“现在 只 剩 下 那个 依赖 第 三 方 类 库 的 TODO 了 ， 把 它 标记 为 working-on。 要 完成 这 个 TODO， 需 要 先 写 一 个 测试 来 表达 使 用 外 覆 类 的 对 象 
在 UnicodeFileToHtmlITextConverter 的 构造 器 中 ， 除 了 传 入 new StringReader ("H&M") ， 再 传 入 一 个 stringEscaper 对 象 。 这 个 对 象 的 类 型 就 是 
需要 在 convertToHtml () 方法 中 ,将 StringEscapeUtils.escapeHtml (line) 替换 为 this.stringEscaper.escapeHtml (line) ， 使 得 该 方法 不 
StringEscaper。 


体 做 法 是 在 构造 器 UnicodeFileToHtmlTextConverter (String) 中 ， 把 传递 进来 的 文件 路 径 转 换 为 Reader。 原 先 的 成 员 变 量 fullFilenameWithPath 就 没有 


的 位 置 ， 作 为 期 望 值 。 


因为 现在 UnicodeFileToHtmlTextConverter 类 已 经 针对 Reader 来 编程 了 ， 所 以 原先 的 构造 器 UnicodeFileToHtmlTextConverter (String) 也 需要 修改 一 下 。” 


处 了 ， 可 以 删除 。 


原先 的 构造 器 UnicodeFileToHtmlTextConverter (String) 以 适应 针对 Reader 编 程 的 代码 如 下 所 示 (CM: Updated the original constructor UnicodeFileToHtmlTextConverter (String) to 


[ 


的 意 | 


。 比 如 我 们 可 以 添加 一 个 转换 Be 字符 的 测试 ， 然 


= 
A 


KEZDE StringEscaper. Ab, ANE 


直 


依赖 第 三 方 类 库 ， 而 是 依赖 咱们 的 外 履 类 


编写 使 


外 履 类 StringEscaper 的 测试 和 convertToHtml () 方法 的 意 | 


[i 


代码 如 下 所 示 (CM: Added test should_convert_ampersand_using_StringEscaper () with intention code using 


StringEscaper which will wrap StringEscapeUtils.escapeHtml () .Wrote intention code in class UnicodeFileToHtmITextConverter to make it depend on StringEscaper instead of third party 


library StringEscapeUtils.) : 
public class UnicodeFileToHtmlTextConverterTest { 
+ @Test 
+ public void should_convert_ampersand_using_StringEscaper() throws IOException { 
+ // Arrange 
+ StringEscaper stringEscaper = new StringEscaper () ; 
4 UnicodeFileToHtmlTextConverter converter = new UnicodeFileToHtmlTextConverter 
(new StringReader ("H&M"), stringEscaper) ; 
+ 
+ // Act & Assert 
+ assertEquals ("H&amp;M<br />", converter.convertToHtml ()); 
+ } 
public class UnicodeFileToHtmlTextConverter { 
while (line != null) 


// TODO-working-on: Depending on the third party library violates the 
Dependency Inversion Principle and Open-Closed Principle 

html += StringEscapeUtils.escapeHtml (line) ; 

html += this.stringEscaper.escapeHtml (line) ; 


html += "<br />"7 
line = reader. readLine (); 


“ 写 完 这些 意 图 代码 后 ， 就 需要 修复 那些 红色 的 编译 错误 。 先 看 那个 新 写 的 测试 。 其 中 StringEscaper 是 编译 错误 的 红色 ， 因 为 尚未 创建 该 类 。 现 在 就 创 对 


Hie 


创建 类 StringEscaper 以 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Created class StringEscaper.) : 


+public class StringEscaper { 
+} 


“ 接 下 来 在 修复 这 个 测试 中 new UnicodeFileToHtmlTextConverter (new StringReader ("H&M") , stringEscaper) 
Reader 和 StringEscaper 这 两 个 参数 的 UnicodeFileToHtmlTextConverter 构 造 器 ， 现 在 就 创建 。” 


um 


面 两 个 带 有 红色 下 划 波 浪 线 的 参数 的 编程 错误 。 错 误 的 原因 是 尚未 创建 带 有 


创建 带 有 Reader 和 StringEscaper 这 两 个 参数 的 UnicodeFileToHtmlTextConverter 构 造 器 以 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Created constructor 
UnicodeFileToHtmlTextConverter (Reader, StringEscaper) .) : 


public class UnicodeFileToHtmlTextConverter { 


public UnicodeFileToHtmlTextConverter (Reader reader, StringEscaper stringEscaper) { 


++; 


“现在 测试 里 面 的 编译 错误 已 经 被 修复 了 。 再 看 看 UnicodeFileToHtmlTextConverter 类 中 的 编译 错误 。 这 里 ，this.stringEscaper.escapeHtml (line) 中 的 stringEscaper 是 红色 ， 因 为 该 成 员 变 量 尚 
未 创建 。 现 在 就 创建 。” 


在 UnicodeFileToHtmlTextConverter 类 中 创建 stringEscaper 成 员 变量 以 修复 编程 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Created field stringEscaper in class 


UnicodeFileToHtmlTextConverter.) : 


public class UnicodeFileToHtmlTextConverter { 
private Reader reader; 
+ private StringEscaper stringEscaper; 


“stringEscaper 的 红色 消失 了 ， 但 后 面 的 escapeHtml () 又 变 红 了 。 因 为 StringEscaper 类 的 escapeHtm () 方法 尚未 创建 ， 现 在 就 创建 。” 


创建 StringEscaper 类 的 escapeHtm () 方法 以 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed compiler error: Created method StringEscaper.escapeHtml () .) : 


public class StringEscaper { 

+ public String escapeHtml (String originalString) { 
+ return null; 
+ } 

} 


“编译 错误 都 修复 了 。 运 行 新 写 的 使 用 StringEscaper 类 的 测试 ， 发 现在 convertToHtml () 方法 中 的 new BufferedReader (this.reader) 语句 有 空 指针 异常 。 原 因 是 带 有 两 个 参数 的 构造 器 
UnicodeFileToHtmITextConverter (Reader, StringEscaper) 是 空 的 ， 尚 未 实现 。 现 在 就 实现 它 。” 


实现 构造 器 UnicodeFileToHtmlTextConverter (Reader, StringEscaper) 以 修复 编译 错误 的 代码 如 下 所 示 (CM: Fixed null pointer exception: Implemented constructor 
UnicodeFileToHtmlTextConverter (Reader, StringEscaper) .) : 


public class UnicodeFileToHtmlTextConverter { 


public UnicodeFileToHtmlTextConverter (Reader reader, StringEscaper stringEscaper) { 


on 


this.reader = reader; 
+ this.stringEscaper = stringEscaper; 


“编译 错误 都 修复 了 。 再 次 运行 新 写 的 使 用 StringEscaper 类 的 测试 ， 发 现 比较 失败 ComparisonFailure。 期 望 值 是 “H&amp; M<br/>' ， 实 际 值 是 “null<b>” 。 这 是 因为 咱们 新 增 的 外 履 类 
StringEscaper 中 的 escapeHtml () 方法 是 空 的 ， 尚 未 实现 。 现 在 就 实现 它 。” 


实现 外 覆 类 StringEscaper 中 的 escapeHtml () 方法 以 修复 比较 失败 的 代码 如 下 所 示 (CM: Fixed comparision failure: Implemented method StringEscaper.escapeHtml () .) : 


public class StringEscaper { 
public String escapeHtml (String originalString) { 
= return null; 
+ return StringEscapeUtils.escapeHtml (originalString) ; 


} 


“运行 所 有 测试 ， 新 写 的 使 用 StringEscaper 类 的 测试 通过 ， 而 前 面 写 的 那 3 个 测试 ， 都 在 convertToHtml () 方法 中 的 this.stringEscaper.escapeHtml (line) 语句 中 抛 出 空 指针 异常 。 这 是 因为 构造 
器 UnicodeFileToHtmlTextConverter (Reader) 尚未 对 新 增 的 stringEscaper 成 员 变 量 赋值 ， 造 成 了 空 指针 。 现 在 就 修复 它 。 顺 便 把 原先 的 构造 器 UnicodeFileToHtmlTextConverter (String) 也 一 并 修 
改 来 对 stringEscaper 成 员 变 量 赋值 。 


让 构造 器 UnicodeFileToHtmlTextConverter (Reader) 和 UnicodeFileToHtmlTextConverter (String) 对 stringEscaper 成 员 变 量 赋值 以 修复 空 指针 异常 的 代码 如 下 所 示 (CM: Fixed null pointer 
error: Updated constructor UnicodeFileToHtmITextConverter (String) and UnicodeFileToHtmlTextConverter (Reader) to call 


UnicodeFileToHtmIiTextConverter (Reader, StringEscaper) .) : 


public class UnicodeFileToHtmlTextConverter { 


public UnicodeFileToHtmlTextConverter (String fullFilenameWithPath) throws 
FileNotFoundException { 
= this.reader = new FileReader (fullFilenameWithPath) ; 


+ this (new FileReader (fullFilenameWithPath), new StringEscaper()); 
} 
public UnicodeFileToHtmlTextConverter (Reader reader) { 

= this.reader = reader; 

+ this (reader, new StringEscaper ()); 


“运行 全 部 测试 ， 通 过 。 现 在 有 关 依 赖 第 三 方 类 库 的 TODO 也 完成 了 ， 可 以 将 其 删除 。 


至 此 ， 这 个 有 关 网 页 文本 转换 系统 的 编程 操练 就 告 一 段落 。 为 了 便于 和 重 构 前 的 代码 进行 比较 ， 下 面 列 出 于 


构 后 UnicodeFileToHtmlITextConverterTest 类 的 代码 如 下 所 示 : 


重 构 后 的 测试 代码 和 生产 代码 。 


public class UnicodeFileToHtmlTextConverterTest { 
@Test 
public void should_convert_ampersand() throws IOException { 
// Berange a a 
UnicodeFileToHtmlTextConverter converter = new UnicodeFileToHtmlTextConverter 
(new StringReader ("H&M") ) ; 
// Act & Assert 
assertEquals ("H&amp;M<br />", converter.convertToHtml () ) 
} 
@Test 
public void should_convert_ampersand_using_StringEscaper() throws IOException { 
// Berange 
StringEscaper stringEscaper = new StringEscaper (); 
UnicodeFileToHtmlTextConverter converter = new UnicodeFileToHtmlTextConverter 
(new StringReader ("H&M"), stringEscaper) ; 
// Act & Assert 
assertEquals ("H&amp;M<br />", converter.convertToHtml () ) ; 
} 
@Test 
public void should convert greater than and less than() throws IOException { 
// Arrange 
UnicodeFileToHtmlTextConverter converter = new UnicodeFileToHtmlTextConverter 
(new StringReader ("> <||1")); 
// Act & Assert E 


assertEquals ("&gt;_&lt; | |1<br />", converter.convertToHtml ()); 

} 

@Test 

public void should_add_a_line break_for_a_new_line() throws IOException { 
// Berange 


UnicodeFileToHtmlTextConverter converter = new UnicodeFileToHtmlTextConverter 
(new StringReader ("Cheers\nBen Wu") ) 7 

// Act & Assert 

assertEquals ("Cheers<br />Ben Wu<br />", converter.convertToHtml () ) 


重 构 后 StringEscaper 类 的 代码 如 下 所 示 : 


public class StringEscaper { 
public String escapeHtml (String originalString) { 
return StringEscapeUtils.escapeHtml (originalString) ; 
} 


中 


构 后 UnicodeFileToHtmlTextConverter 类 的 代码 如 下 所 示 : 


public class UnicodeFileToHtmlTextConverter { 

Private Reader reader; 

private StringEscaper stringEscaper; 

public UnicodeFileToHtmlTextConverter (String fullFilenameWithPath) throws 
FileNotFoundException { 
this (new FileReader (fullFilenameWithPath), new StringEscaper()); 

} 

public UnicodeFileToHtmlTextConverter (Reader reader) { 
this (reader, new StringEscaper ()) 7 

} 

public UnicodeFileToHtmlTextConverter (Reader reader, StringEscaper stringEscaper) { 
this.reader = reader; 
this.stringEscaper = stringEscaper; 

} 

public String convertToHtml() throws IOException{ 
BufferedReader reader = new BufferedReader (this.reader) ; 
String line = reader.readLine(); 
String html = ""; 
while (line != null) 


html += this.stringEscaper.escapeHtml (line) ; 
html += "<br />"; 
line = reader.readLine(); 


} 
return html; 


至 此 ， 我 和 亲爱 的 读者 您 之 间 的 结对 编程 就 告 一 段落 了 。 下 一 章 将 总 结 驯服 烂 代码 的 步骤 。 在 总 结 之 前 ， 让 我 们 看 看 本 章 都 做 了 哪些 工作 。 


= 


阅读 网 页 文本 转换 系统 的 代码 ， 包 含 UnicodeFileToHtmlTextConverter 类 。 


2) 记录 了 依赖 于 new 出 来 的 FileReader 的 具体 实现 ， 从 而 违反 了 依赖 倒置 和 开 闭 原则 的 TODO。 


Ww 


记录 了 直接 使 用 第 三 方 类 库 ， 从 而 违反 了 依赖 倒置 和 开 闭 原则 的 TODO。 


4) 记录 了 一 个 要 完成 的 新 特性 的 TODO。 


5) 记录 了 3 个 用 户 意 


测试 的 TODO。 


[ 


6) 先 写 了 测试 的 Assert 部 分 的 意图 代码 ， 然 后 再 推导 出 Act 和 Arrange 部 分 的 测试 意图 代码 ， 并 通过 修复 意图 代码 的 编译 和 测试 运行 错误 ， 来 驱动 出 生产 代码 ， 从 易 到 难 地 完成 上 述 TODO。 


库 。 


7) 用 外 覆 类 包装 了 针对 第 三 方 类 库 的 使 用 ， 即 在 第 三 方 类 库 的 外 面 外 覆 一 个 类 ， 然 后 让 生产 代码 针对 这 个 外 覆 类 的 接口 编程 ， 而 让 第 三 方 类 库 在 这 个 外 覆 类 中 实现 这 些 接口 ， 以 便于 将 来 更 换 第 三 方 类 


8) 当 不 大 了 解 要 测试 的 SUT 的 实际 行为 时 ， 使 用 了 特征 测试 的 方法 来 进行 测试 。 即 可 以 故意 在 测试 的 断言 中 填写 一 个 不 正确 的 期 望 结 果 ， 然 后 让 测试 运行 到 这 里 。 一 般 测试 到 这 里 会 运行 出 错 ， 并 在 


错 信息 中 给 出 实际 值 。 此 时 可 以 把 出 错 信息 中 的 实际 值 填 写 到 测试 断言 中 的 期 望 值 那里 ， 来 让 测试 运行 通过 。 


9) 通过 操练 我 们 学 到 了 以 下 技能 : 


a) 运行 速度 慢 的 不 是 单元 测试 。 与 数据 库 、 网 络 、 文 件 系统 和 配置 文件 有 交互 的 测试 不 是 单元 测试 。 


cc 


b) 单元 测试 要 测 的 仅仅 是 SUT 里 


E 


的 软件 行为 ， 而 不 是 测试 SUT 与 诸如 数据 库 、 网 络 和 文件 系统 这 些 DOC 之 间 是 否 能 正常 交互 。 


c) 要 把 SUT 与 诸如 数据 库 、 网 络 、 文 件 系统 这 些 的 DOC 之 间 进 行 交互 的 集成 测试 ， 转 变 为 针对 SUT 的 单元 测试 ， 可 以 先 找 到 DOC 的 接口 ， 让 SUT 针 对 这 个 接口 编程 ， 并 且 编写 一 个 运行 起 来 经 济 快捷 的 


Test Double 来 实现 这 个 接口 ， 并 注入 SUT 中 ， 让 SUT 把 这 个 Test Double 当 成 那个 接口 来 使 用 。 这 样 就 能 把 依赖 


[1 葡萄 牙 语 中 国 制造 的 意思 。 


于 DOC 的 集成 测试 ， 转 换 为 依赖 于 实现 接口 的 Test Double 的 单元 测试 。 


2 HL ThoughtWorks Studio 的 培训 师 和 教练 Luca Minudel 在 2012 年 设计 并 上 传 到 GitHub 上 的 编程 操练 系列 题目 TDD with Mock Objects, JL: 
https://github.com/lucaminudel/TDDwithMockObjectsAndDesignPrin ciples o 

B] Unicode File to HTML Text Convertetr 操 练 题目 原 有 代码 参见 : https://github.com/wubin28 /tbe-unicode-fileto-html-text-converter-java/tree/exercise ; 本 书 针 对 该 题目 的 操练 步骤 代码 参见 : 
https://github.com/wubin28/tbc-unicode-file-to-html-text-converter-java/tree/no-wrapper s 


轩 在 Java 语 言 中 ，javaio.Readet 是 一 个 抽象 类 。 


第 19 章 “驯服 烂 代码 的 步骤 : lePpTr 


和 面 给 烂 代码 下 了 定义 后 ， 让 我 们 看 看 驯服 烂 代 码 的 可 操作 的 步骤 。 从 前 面 所 得 出 的 在 拜 唐僧 为 师 时 的 孙悟空 是 一 段 烂 代码 的 结论 可 以 看 出 ， 烂 代码 好 像 一 个 人 ， 而 且 是 一 个 有 正常 行为 能 力 的 、 同 时 
有 一 身 小 毛病 或 正在 学 习 和 修行 的 、 还 没有 最 终 觉悟 、 在 修正 自身 缺陷 和 学 习 修行 上 进步 与 反馈 迟缓 的 人 。 


ay 


在 字典 里 ，“ 驯 服 ” 的 意思 是 “使 顺从 ”。 那 么 如 何 才能 使 烂 代码 “顺从 ” 呢 ? 既然 烂 代码 像 人 ， 那 么 我 们 可 以 换个 问 法 ， 如 何 才 能 使 一 个 人 “顺从 ” 呢 ? 孙子 日 : "“MORIR, BAA.” a 
使 人 顺从 ， 首 先 要 做 的 是 了 解 这 个 人 。 那 么 ， 如 何 才 能 了 解 一 个 人 呢 ? 


距 今 2500 多 年 前 的 一 天 上 午 ， 和 孔子 在 学 校 里 溜达 ， 忽 然 发 现 他 的 学 生 宰 予 趴 在 课 桌 上 有 睡 大 觉 。 孔 子 看 了 很 生气 ， 回 到 课堂 上 ， 对 弟子 们 说 : “ 宰 予 这 孩子 况 敢 骗 我 ! WATERSS SSE, S 
改 掉 白天 睡觉 这 个 坏 毛病 。 谁 知道 今天 上 午 ， 我 又 碰 到 他 趴 在 桌子 上 有 睡 大 觉 ! 真是 朽木 不 可 雕 也 ， 垃 圾 做 的 墙壁 不 可 粉刷 也 ! 对 宣 予 这 孩子 ， 我 还 能 说 他 什么 好 呢 ? ”过 了 会 ， 老 先生 余 她 未 消 ， 接 着 
说 : “以 前 ,我 听 一 个 人 所 说 的 话 ， 就 会 相信 他 的 行为 。 今 天 宣 予 的 事情 ， 让 我 从 今 往 后， 在 了 解 一 个 人 时 ， 不 仅 要 听 他 所 说 的 话 ， 还 要 看 他 所 做 的 事 。[” 


网 


上 面孔 子 的 那 段 话 ， 告 诉 我 们 ， 要 了 解 一 个 人 ， 不 仅 要 听 其 言 ， 更 要 观 其 行 。 前 面 说 过 ， 烂 代码 像 一 个 人 ， 那 么 要 了 解 一 段 烂 代码 ， 也 不 仅 要 听 其 言 ， 即 看 代码 本 身 、 文 档 及 注释 来 理解 代码 的 意 
更 要 观 其 行 ， 即 用 运行 测试 代码 的 方式 来 验证 代码 是 否 言行 一 致 。 


对 


“ 听 其 言 而 观 其 行 ” 的 方式 了 解 了 一 段 代码 之 后 ， 我 们 又 该 如 何 使 代码 “顺从 ” 呢 ? 老子 说 : “ ' 道 ”经 常 是 处 于 无 名 和 质朴 的 状态 。 “ 道 ” 虽然 很 小 ， 但 是 天 下 没有 谁 能 够 征服 ' 道 的 。 天 下 
的 诸侯 若 能 坚守 这 个 “ 道 。， 那 么 世间 的 万 物 都 将 自己 会 顺从 。[ 所 ”看 来 咱们 只 要 在 写 代码 时 遵守 这 个 “ 道 ”， 那 么 代码 自己 就 会 顺从 于 咱们 。 那 么 这 个 “ 道 ”到 底 在 哪里 呢 ? 


i} 


在 距 今 500 多 年 前 的 一 天 ， 一 位 明 朝 的 官员 ， 因 为 反对 宦官 而 被 朝廷 打 了 板子 ， 随 后 被 降 职 并 发 配 到 生活 条 件 十 分 艰苦 的 贵州 龙 场 。 这 位 官员 也 在 日 日 夜 夜 苦 苦 思索 这 个 问题 : “ E RER 
里 ? ”终于 ， 在 一 个 夜晚 ， 他 大 喊 一 声 : “找到 啦 ! È MER ROLE! 圣人 之 道 ， 看 性 自足 ! ”这 就 是 历史 上 著名 的 “ 龙 场 悟道 ”， 这 位 官员 ， 就 是 中 国 历史 上 罕有 的 “三 不 朽 B]” 的 人 物 之 一 
一 一 王阳明 。 


E 


我 们 每 一 个 人 ， 都 来 自 大 自然 ， 同 时 也 是 大 自然 的 一 部 分 。 大 自然 中 蕴涵 的 “ 道 ”， 也 同样 蕴涵 在 我 们 每 一 个 人 的 内 心 。 如 此 说 来 ， 编 写 代码 的 “ 道 ”， 也 蕴涵 在 每 一 位 程序 员 的 内 心 之 中 。 


或 许 有 人 会 问 : “既然 “ 道 ， 在 每 个 程序 员 的 内 心中 ， 那 么 程序 员 就 不 应 该 写 出 那么 多 不 遵守 “ 道 ” 的 烂 代码 。 如 果 是 这 样 的 话 ， 那 么 现在 充斥 在 项 目 中 的 大 量 烂 代码 又 该 如 何 解释 呢 ?“ 


对 于 这 个 问题 ， 王 阳 明 最 得 意 的 门生 徐 爱 曾 说 过 这 样 一 段 话 : “人 的 内 心 就 像 一 面 镜子 。 圣 人 内 心 的 镜子 十 分 明亮 ， 而 常人 内 心 的 镜子 则 比较 昏暗 。 如 果 按 照 朱熹 的 “格物 致 得 ”的 方法 来 寻求 存在 于 
每 一 个 物件 之 中 的 WE’ ， 那 么 就 好 比 用 镜子 照 物 时 在 “ 照 ” 上 下 工夫 ， 而 全 然 不 顾 自己 的 内 心 是 不 是 昏暗 ， 这 样 照 镜子 能 照 得 好 才 怪 呢 。 而 王阳明 先生 的 “格物 ”， 就 好 比 把 镜子 控 亮 ， 是 在 R EF 
工夫 。 等 把 镜子 擦 亮 了 ， 自 然 就 能 照 镜子 照 得 好 了 。 办 ” 


这 样 看 起 来 ， 目 前 世上 现存 的 所 有 烂 代 码 ， 都 是 程序 员 内 心 的 “镜子 ”没有 被 擦 亮 而 导致 的 。 而 如 果 程 序 员 把 内 心 的 “镜子 ” 擦 亮 会 怎样 就 会 “ 照 ” 出 像 设计 模式 、 面 向 对 象 的 SOLID 设 计 原则 Pl]、 
晶 构 、 测 试 驱 动 开 发 (Test-Driven Development, TDD) 、 敏 捷 软 件 开发 、 精 益 这 些 软 件 开发 的 “ 道 ”。 


中 | 


这 里 需要 注意 的 是 ， 干 万 不 可 把 用 异 暗 的 “镜子 ”所 照 出 的 那些 “ 反 模 式 !6)” 当 成 软件 开发 之 “ 道 ”。 在 编写 代码 中 最 典型 的 反 模 式 就 是 为 图 方便 而 使 用 快捷 键 Ctrl+ C 和 Ctrl+V 来 复制 和 粘贴 代码 
的 “CV 大 法 ”， 另 外 在 《 重 构 》 一 书 所 列 出 的 22 种 代码 “ 腐 自 ” 中 也 能 找到 其 他 的 反 模式 。 


人 的 内 心 除 了 可 以 比 作 镜子 ， 还 可 以 比 作 玉 石 。 玉 石 在 雕琢 前 ， 被 称 为 “ 现 玉 ”或 “ 玉 原 石 ”。 玉 原石 在 开采 时 ， 粗 糙 不 平 的 原石 表面 一 定 履 盖 着 厚 厚 的 尘土 ， 这 好 比 人 内 心 上 履 盖 着 的 名 与 利 的 滚滚 
红尘 。 要 把 这 块 玉 原 石雕 琢 成 一 块 美玉 ， 我 们 首先 要 除去 尘土 ， 然 后 切 开 玉石 (D). ERE (0%) 和 雕琢 花纹 ( 琢 ) ， 最 后 打磨 抛光 ( 磨 ) 。 而 正 处 于 修 制 成 型 和 雕琢 花纹 阶段 的 玉石 ， 就 好 比 正在 不 
断 学 习 和 修行 的 人 的 内 心 ; 经 过 最 后 打磨 抛光 后 的 美玉 ， 就 好 比 大 彻 大 悟 最 终 得 道 的 圣人 的 内 心 。 


一 旦 我 们 掌握 了 烂 代码 的 所 言 和 所 行 ， 我 们 就 能 了 解 烂 代码 。 在 了 解 了 烂 代码 后 ， 我 们 程序 员 还 需要 时 时 刻 刻 把 自己 内 心 的 那 面 “镜子 ” 擦 亮 ， 或 把 自己 内 心 的 那 块 瑛 玉 磨 亮 ， 去 照 出 并 坚守 软件 开发 
之 “ 道 ”， 这 样 我 们 就 可 以 驯服 烂 代 码 。 


驯服 烂 代码 不 仅 需要 “ 听 其 言 、 观 其 行 、 守 其 道 ”， 还 需要 一 个 可 以 操作 的 具体 步骤 。 我 们 固然 可 以 把 前 面 用 TDD 开 发 方法 做 编程 操练 的 过 程 归纳 一 下 ， 形 成 一 个 可 供 参 考 的 步骤 ， 但 生动 的 比喻 胜 过 
枯燥 的 归纳 。 在 归纳 之 前 ， 我 们 不 妨 继续 看 这 个 用 作 比 喻 的 观音 菩萨 助 唐僧 教化 悟空 的 故事 ， 看 看 驯服 悟空 的 过 程 是 个 什么 样子 。 


从 石头 中 中 出 来 的 悟空 ， 身 上 有 许多 毛病 和 bug。 而 对 于 唐僧 和 观音 菩萨 来 说 ， 悟 空 最 大 的 bug 便 是 一 味 行凶 杀生 。 如 果 回味 一 下 前 面 描 述 的 观音 车 萨 助 唐僧 教化 孙悟空 的 过 程 ， 我 们 会 发 现 观音 采用 
的 方法 是 这 样 的 : 首先 ， 在 依 如 来 佛 旨意 去 找 取经 人 路 过 两 界 山 时 ， 规 劝 悟空 不 再 行凶 、 版 依 佛法 和 保护 取经 人 ， 并 听 悟 空 将 这 些 劝告 的 意图 都 答应 下 来 ， 这 就 是 “ 听 其 言 ”。 然 后 让 唐僧 收 悟空 为 徒 ， 看 
到 悟空 行凶 并 搬 下 师父 后 ， 给 唐僧 准备 了 能 令 悟空 信守 承诺 的 衣服 和 帽子 ， 并 教 其 念 紧 短 咒 ， 让 猴子 在 好 奇 心 的 驱使 下 自己 穿戴 上 ， 而 帽子 中 就 隐藏 着 用 于 矫正 悟空 bug 行 为 的 金竹 。 观 音 车 萨 观察 悟空 的 
一 举 一 动 ， 并 做 出 一 系列 能 让 前 面 悟空 答应 的 事情 得 到 落实 的 行为 ， 就 是 “ 观 其 行 ”。 最 后 ， 令 唐僧 每 当 需 要 依照 佛法 教诲 犯错 的 悟空 时 ， 就 默念 紧 短 加 ， 疼 得 猴子 伏地 求饶 ， 死 心 塌 地 地 版 依 佛法 ， 这 就 


如 果 把 悟空 换 做 烂 代码 ， 那 么 驯服 烂 代码 的 步骤 如 下 : 


1) 听 其 言 ， 维 护 TODO 列 表 [中 、 编 写 用 户 意图 测试 和 意图 代码 。TODO 列 表 就 是 意图 列表 。 程 序 员 可 以 收集 并 审查 所 有 当前 和 今后 要 做 的 诸如 用 户 意图 测试 、bug 修 复 和 代码 “ 腐 臭 ”治理 这 样 的 任 
务 ， 形 成 一 个 用 意图 来 表达 的 TODO 列 表 。 然 后 根据 当时 的 情况 ， 或 者 选择 一 个 条 件 已 经 具备 县 有 信心 完成 的 用 户 意图 TODO 作 为 下 一 步 要 开发 的 任务 ， 把 它 标记 为 working-on， 根 据 用 户 意图 做 出 合理 的 
分 析 和 设计 ， 根 据 设计 意图 编写 用 户 意图 测试 或 意图 代码 。 可 以 把 每 条 TODO 都 以 代码 注释 的 方式 写 到 代码 相关 位 置 ， 并 用 DE 的 TODO 管 理 界面 加 以 管理 。 对 于 已 经 完成 的 TODO， 就 可 以 从 列表 中 删除 。 


2) 观 其 行 ， 以 修复 编译 错误 和 测试 运行 错误 为 指引 编写 恰好 够 用 的 生产 代码 ， 直 至 测试 运行 通过 。 首 先 以 上 一 步 所 编写 的 意图 代码 的 红色 编译 错误 为 指引 ， 当 信心 弱 时 可 以 编写 尽量 少 的 生产 代码 (BD 
可 以 写 空 类 和 空 方法 ) ， 当 信心 强 时 可 以 写 自 认 为 合理 的 生产 代码 加， 来 让 测试 代码 和 生产 代码 编译 通过 。 然 后 运行 测试 ， 当 发 现 测试 运行 中 的 诸如 空 指针 这 样 的 测试 运行 错误 后 ， 以 这 些 错误 为 指引 ， 同 
样 当 信 心 弱 时 编写 尽量 少 的 生产 代码 (可 以 写 假 数据 ) ， 当 信心 强 时 可 以 写 自 认为 合理 的 生产 代码 ， 让 测试 运行 通过 。 


3) 守 其 道 ， 全 面 重 构 TODO 列 表 、 测 试 代 码 和 生产 代码 。 首 先 要 “ 嗅 一 嗅 ” 上 一 步 令 测试 运行 通过 的 生产 代码 中 ， 是 否 有 代码 “ 腐 臭 ”。 如 果 有 ， 就 要 在 经 常 运行 测试 的 情况 下 小 步 重 构 生 产 代码 ， 以 
消除 “ 腐 臭 ”。 然 后 根据 诸如 面向 对 象 设计 的 SOLID 原 则 、 已 知 的 或 更 新 后 的 产品 特性 和 设计 模式 这 些 软件 开发 的 “ 道 ” 的 层面 的 概念 ， 来 审查 目前 所 有 的 测试 代码 和 生产 代码 ， 来 找 出 其 中 诸如 不 再 合理 


的 测试 、 代 码 “ 腐 臭 ”、 被 遗漏 的 User Story 或 刚刚 从 测试 工程 师 


面 重 构 ”, H 


注意 这 里 的 “ 
这 个 定义 描述 了 在 


在 做 上 面 第 3 步 “ 守 其 道 ” 时 ， 
修改 ， 以 改进 程序 的 内 部 结构 。” 


zJ Martin Fowler * "g 


， 渐 渐变 得 不 


ez 


Eo 


很 多 以 前 认为 是 合理 的 软件 外 在 行为 的 预 基 
上 述 软件 外 在 行为 的 变化 ， 需 要 对 该 定义 进行 扩 


重 构 ” 


ETEK, MI 


H 


不 妨 把 这 个 扩 
发 的 “ 道 的 


重 构 的 具体 步骤 如 下 : 


H 


1) 审视 并 更 新 TODO 列 表 ， 删 除 已 经 完成 的 任务 ， 添 加 新 发 现 的 任务 ， 确 


2) 根据 程序 员 的 经 验 ， 从 TODO 列 表 中 挑选 一 个 


合理 ， 而 需要 调整 这 些 软件 久 


(Total Refactoring) 。 本 书 对 
面 的 概念 前 提 下 ， 对 记录 未 完成 任务 的 TODO 列 表 、 测 试 代码 和 生产 代码 进行 修改 ， 以 改进 代码 的 内 部 结构 的 过 程 。 


H] 


重 构 的 定义 如 下 : 在 遵从 诸如 


B44)" AYE. Martin FowleriZz 
测试 代码 固定 生产 代码 外 在 行为 的 前 提 下 ， 改 进 生 产 代 码 的 内 部 结构 的 过 程 。 它 适合 于 代码 外 在 行为 符合 预期 的 情况 。 但 随 着 软件 开发 的 不 断 进 
在 行为 。 而 对 软件 外 在 行为 的 调整 ， 意 味 着 要 跟着 调整 相应 的 测试 ， 以 固 


H] 


认为 最 合理 的 任务 作为 下 一 个 任务 。 


且 接 到 的 bug 报 告 等 内 容 ， 并 以 TODO 的 形式 记录 下 来 ， 补 充 到 “ 听 其 言 


保 该 列表 反映 了 当下 所 有 已 知 的 尚未 完成 的 任务 。 


时 构 定义 为 这 样 一 种 过 程 : 


步骤 中 的 TODO 列 表 中 ， 来 进入 下 一 个 迭代 。 


“在 不 改变 代码 外 在 行为 的 前 提 下 ， 对 代码 做 出 
展 ， 


化 新 的 软件 外 在 行为 。 为 了 在 重 构 中 应 对 


H 


3) 编写 或 修改 与 上 述 选 出 的 任务 相关 的 测试 代码 ， 一 方 | 


确保 测试 代码 


[E] 


化 了 当下 合理 的 软件 外 在 行为 ， 


4) 在 频繁 运行 上 述 测试 代码 的 前 提 下 ， 对 生产 代码 做 出 修改 ， 以 改进 程序 的 内 部 结构 。 


一 


方 


确保 测试 代码 调 


了 当下 合理 的 生产 代码 的 接口 。 


向 对 象 设 计 的 SOLID 原 则 、 当 下 更 新 后 的 产品 特性 和 消除 代码 “ 腐 臭 ”等 这 些 软件 开 


上 面 讨论 了 驯服 像 悟 空 这 样 有 bug 的 烂 代码 的 步骤 。 但 如 果 回 顾 一 下 前 面 用 TDD 开 发 方法 做 的 那个 酒店 世界 时 钟 编程 操练 的 步骤 ， 就 可 以 看 出 ， 上 述 驯服 有 bug 的 烂 代码 的 步 又， 同样 也 适用 于 开发 一 
个 尚未 编写 任何 代码 的 全 新 的 软件 项 目 。 昌 然 上 述 步骤 对 这 两 种 情况 都 适用 ， 但 二 者 还 是 有 些 区 别 。 主 要 区 别 在 于 ， 前 者 在 编写 意图 代码 时 ， 需 要 不 断 地 参考 已 有 代码 的 现 有 接口 ;而 后 者 由 于 生产 代码 尚 
未 编写 ， 所 以 在 编写 意图 代码 时 可 以 自由 定义 生产 代码 所 需 提 供 的 接口 。 由 此 看 来 ， 使 用 测试 先行 的 TDD 开 发 方法 编写 一 个 全 新 的 功能 ， 比 起 先 写生 产 代码 再 后 补 测试 的 测试 后 行 的 开发 方法 的 难度 要 小 得 
多 ， 且 代码 的 可 测 性 也 会 天 然 地 好 很 多 。 

在 统一 了 驯服 已 有 烂 代码 和 编写 全 新 项 目的 新 代码 的 开发 步骤 后 ， 我 们 不 妨 把 这 种 开发 步骤 起 一 个 名 字 : lePpTr。 如 果 把 TDD 开 发 方法 比 作 一 个 接口 ， 那 么 lePpTr 就 是 TDD 的 一 种 实现 。 

lePpTr 表 示 Intent-ErrorProductionPassed-TotalRefactoring。 字 母 组 合 TR 前 面 的 横 线 ， 表 示 这 个 TR 所 代表 的 全 面 重 构 ， 不 仅 需 要 实施 到 前 面 的 字母 P 所 代表 的 Production Code 上 ， 而 且 还 需要 实施 


图 测试 和 意图 代码 上 。 


的 字母 | 所 代表 的 TODO、 用 户 意 


到 前 


H 


TDD 的 一 种 实现 : lePpTr。 


。 在 讨论 如 何 形成 习惯 之 前 ， 先 回顾 一 下 本 章 的 内 容 : 


1) 听 其 言 : Intent (TODOs + User Intent Tests + Intention Code) 

2) 观 其 行 : Test Run Error Fixing (Compiler Errors + Test Run Errors) , Production Code, Test Run Passed 
3) 守 其 道 : Total Refactoring 

lePpTr 的 示意 图 如 图 19-1 所 示 。 

在 了 解 了 驯服 烂 代码 的 步骤 后 ， 我 们 需要 把 这 些 步骤 化 为 习惯 ， 才 能 让 它们 在 我 们 的 日 常 工 作 和 编程 操练 中 发 挥 作 
1) 驯服 烂 代码 的 lePpTr 方 法 是 TDD 开 发 方法 的 一 种 实现 ， 可 以 分 为 3 步 : RS 


道 ( 


测试 运行 通过 ) 、 守 其 


生产 代码 ， 直 至 


外 试 和 意 


(维护 TODO 列 表 、 编 写 上 


户 意 


spl 


面 重 构 TODO 列 表 、 测 试 代码 和 生产 代码 ) 。 


CHS) . WAT 〈 以 修复 编译 错误 和 测试 运行 错误 为 指引 编写 恰好 够 有 


An Implementation of TDD: IePpTr 


1. INTENT: TODOs 
+ User Intent Tests 
+Intention Code 


2.1. Test R 
eiom Jan 
FACTORING Errors + Tes 
Run Errors 


2.3. 


2.2. 
PRODUCTION 
Code 


619-1 囊 服 烂 代码 的 步骤 : IePpTr 


内 


2) Total Refactoring 全 面 重 构 ， 是 为 了 适应 软件 开发 过 程 中 软件 外 在 行为 会 逐渐 发 生变 化 的 情况 ， 而 对 传统 重 构 概念 所 做 的 扩展 。 这 种 扩展 强调 在 遵从 软件 开发 的 “ 道 ” 的 前 提 下 ， 对 记录 未 完成 任 


务 的 TODO 列 表 、 测 试 代码 和 生产 代码 进行 修改 ， 以 改进 代码 的 内 部 结构 的 过 程 。 


4] 
5 


6 
7 
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出 自 《 论 语 》， 公 治 长 。 
出 自 老 子 《道德 经 》 第 三 十 二 章 : “ 道 常 无 名 ， 朴 。 虽 小 ， 天 下 葛 能 臣 。 候 王 若 能 守之 ， 万物 将 自 宾 。” 


我 国 伦理 思想 史上 的 一 个 命题 。 春 秋 时 鲁 国 大 夫 叔 孙 狗 称 “ 立 德 ”。、“ 立 功 ”、“ 立 言 ” 为 “三 不 朽 ”。“ 立 德 ”， 即 树立 高 尚 的 道德 ; “立功 ”， 即 为 国 为 民 建立 功绩 ; “立言 ”， 即 提出 具有 真知 灼 


的 言论 。 此 三 者 是 虽 久 不 废 ， 流 芳 百 世 的 。 一 般 认 为 我 国 历史 上 能 够 做 到 真 三 不 朽 的 只 有 两 个 半 人 ， 分 别 是 大 成 至 圣 先 师 孔 子 、 王 文成 公 王守仁 《 别 号 阳 明 ) 和 曾 文 正 公 曾 国 落 ( 半 个 ) 。 一 一 引 自 百度 
百科 
出 自 《 传 习 录 》。 


面向 对 象 的 SOLID 设 计 原 则 ， 即 下 面 5 种 设计 原则 的 英文 首 字 母 : 单一 职责 原则 SRP (Single-Responsibility Principle) 、 开 闭 原则 OCP (Open/Closed Principle) 、 里 氏 替 换 原 则 LSP (Liskov Substitution 


Principle) 、 接 口 隔离 原则 ISP (Interface Segregation Principle) 和 依赖 倒置 原则 DIP (Dependency-Inversion Principle) , #JURobert C.Mattin 所 著 《 敏 捷 软 件 开发 : 原则 、 模 式 与 实践 》 一 书 。 

反 模式 (Anti-pattern or Antipattern) 是 一 种 针对 经 常 发 生 的 问题 所 作出 的 通常 无 效 的 常见 应 对 方法 ， 这 种 方法 会 带 来 高 度 的 起 反作用 的 风险 。 一 一 引 自 wikipedia.org 

维护 TODO 列 表 的 想法 受 Kent Beck 的 著作 《Test-Driven Development By Example》 一 书 的 启发 。Beck 在 书 中 使 用 了 笔 和 便签 来 维护 要 做 的 任务 ， 我 把 这 种 方式 转变 为 在 代码 中 编写 TODO 注 释 ， 并 用 IDE 
来 管理 TODO 列 表 。 用 TODO 注 释 的 方式 来 记录 任务 有 两 个 好 处 : 一 方面 可 以 把 TODO 列 表 纳 入 版 本 管理 系统 进行 保存 ， 避 免 便签 丢失 的 情况 ; 另 一 方面 ， 把 TODO 以 注释 的 形式 写 在 相关 的 代码 边 上 ， 便 
于 程序 员 找到 与 这 个 TODO 相 关 的 代码 。 

感谢 微 博 网 友 @pkuxkxjason 有 关 “TDD 小 步 前 进 因 人 而 异 ， 一 味 强调 写 尽量 少 的 代码 是 低 效 的 ”观点 。 


第 20 章 ”习惯 出 自 专注 、 长 期 和 用 心 的 结对 操练 


1945 年 ， 二 战 接近 尾声 。 一 位 潜伏 在 德国 纳粹 党 卫 军 内 部 的 苏联 特工 凯特 快要 生 孩 子 了 。 
为 了 让 她 能 够 打 入 党 卫 军 内 部 ， 苏 联 方面 做 了 长 时 间 的 精心 准备 。 他 们 通过 特殊 训练 ， 让 凯特 学 会 了 德国 一 个 村 庄 的 方言 ， 然 后 埃 炸 了 这 个 村 庄 ， 令 全 体 村 民 无 一 幸免 。 这 样 ， 凯 特 就 能 以 这 个 村 庄 唯 


一 幸存 者 的 身份 ， 说 着 流利 的 、 带 有 这 个 村 庄 的 口音 的 德语 ， 打 入 党 卫 军 。 


凯特 的 领导 施 季 里 荧 提 醒 她 : “ 生 孩 子 时 要 到 别处 去 生 ,或 者 记得 用 德语 喊叫 ， 不 要 暴露 你 是 俄国 人 。” 不 久 ， 凯特 的 住所 遭 到 了 友 炸 。 凯 特 被 人 从 瓦砾 中 解救 出 来 ， 并 送 往 医院 去 生 孩 子 。 在 医院 


里 ,凯特 的 身份 被 暴露 了 。 因 为 她 在 生 孩 子 的 极度 疼痛 中 ， 不 由 自主 地 喊 出 了 俄语 [1 


为 什么 凯特 在 习惯 了 讲 德语 后 ， 却 在 生 孩 子 过 程 中 因 疼 痛 叫 喊 时 ， 又 操 起 了 讲 俄 语 的 老 习 惯 呢 ? 


Charles Duhigg 在 《习惯 的 力量 》 四 一 书 中 讲 到 的 有 关 习 惯 的 一 个 原理 ， 能 够 解释 上 面 凯特 的 故事 : “习惯 是 不 能 被 消除 的 ， 而 只 能 被 代替 。” 换 句 话 说， 凯特 讲 俄语 的 习惯 ， 虽 然 能 被 通过 特殊 训练 
而 掌握 的 讲 德语 的 新 习惯 所 替代 ， 但 是 它 并 没有 被 消除 ， 而 是 潜伏 在 意识 深 处 。 一 旦 人 所 能 承受 的 外 在 压力 增 大 到 超过 一 定 限 度 时 ， 旧 习惯 就 有 可 能 会 取代 新 习惯 而 伺机 冒 出 。 


上 面 提 到 的 “ 察 且 择 、 听 其 言 、 观 其 行 、 守 其 道 ”， 就 是 TDD 开 发 新 习惯 。 而 程序 员 原 先 不 写 测试 代码 、 编 写 main () 方法 进行 测试 或 写 完 生产 代码 后 再 补 测试 等 作法 ， 都 是 一 些 旧 的 习惯 。 在 了 解 了 
上 面 那个 有 关 习 惯 的 原理 后 ， 我 们 就 会 知道 ， 程 序 员 身上 的 那些 旧 习 惯 是 不 可 能 被 连 根 拔除 的 。 要 想 让 程序 员 使 用 TDD 开 发 方法 ， 来 开发 出 在 代码 行为 理解 、 问 题 感知 和 质量 维护 方面 都 反馈 迅速 的 整洁 代 
码 ， 我 们 首先 需要 让 程序 员 养 成 TDD 开 发 的 新 习惯 ， 来 蔡 代 原来 的 旧 习 惯 。 


那么 如 何 才能 养 成 一 个 新 习惯 ， 并 蔡 代 以 前 的 旧 习 惯 呢 ? 在 讨论 这 个 问题 之 前 ， 咱 们 先 看 看 什么 是 习惯 和 习惯 是 如 何 工作 的 。 


根据 《习惯 的 力量 》 这 本 书 的 描述 ， 每 个 人 所 做 出 的 每 一 个 行为 ， 要 么 是 由 大 脑 中 负责 “决定 ”的 部 分 来 完成 的 ， 要 么 是 由 大 脑 中 负责 “习惯 ”的 部 分 来 完成 的 。 其 中 ， 大 脑 中 负责 “决定 ”的 部 分 需 
要 时 间 来 思索 才能 做 出 行为 ， 而 负责 “习惯 ”的 部 分 则 可 以 不 假 思索 地 “自动 ”做 出 习惯 了 的 行为 ， 所 以 用 习惯 做 事情 会 更 加 快速 。 该 书 援引 杜 克 大 学 2006 年 发 布 的 研究 报告 说 : 人 每 天 有 40% 的 行为 并 不 
是 真正 由 “决定 ”促成 ， 而 是 出 于 “习惯 ” 。 


这 就 好 比 11 年 前 ， 我 刚刚 习惯 了 开 自 家 的 汽车 后 ， 就 能 一 边 开 车 ， 一 边 听 广 播 。 我 在 开车 时 踩 油门 、 踩 刹车 和 开 转 向 灯 等 动作 都 是 不 假 思 索 的 “习惯 ” ， 而 听 广 播 则 是 需要 思索 的 “决定 ”。 


根据 《习惯 的 力量 》 一 书 的 结论 ， 我 们 大 脑 的 “习惯 ”的 工作 方式 是 “一 个 由 3 步 组 成 的 回路 。 第 1 步 ， 存 在 着 一 个 上 暗示， 能 让 大 脑 进 入 某 种 自动 行为 模式 ， 并 决定 使 用 哪 种 习惯 。 第 2 步 ， 存 在 一 个 惯 
常 行为 ， 这 可 以 是 身体 、 思 维 或 情感 方面 的 。 第 3 步 则 是 奖赏 ， 这 让 您 的 大 脑 辨 别 出 是 否 应 该 记 下 这 个 回路 ， 以 备 将 来 之 用 


我 们 还 是 拿 用 旧 习 惯 编程 来 打 比 方 ， 比 如 我 们 打开 计算 机 ， 启 动 1DE 准 备 编程 ， 这 就 是 上 面 第 1 步 中 的 那个 暗示 ， 以 便 让 大 脑 决定 进入 某 种 编程 习惯 ; 接着 我 们 用 旧 的 惯常 行为 不 假 思 索 地 首先 编写 生产 
代码 ， 就 是 第 2 步 ; 然后 我 们 完成 生产 代码 的 编写 ， 之 后 再 编写 一 个 main () 方法 来 测试 一 下 ， 当 看 到 main () 方法 的 输出 结果 符合 我 们 的 预期 时 ， 就 是 第 3 步 里 面 的 那个 奖赏 ， 来 让 我 们 的 大 脑 记录 下 来 
这 个 回路 ， 以 备 后 用 。 


在 了 解 了 习惯 的 工作 方式 之 后 ， 我 们 可 以 看 出 ， 如 果 我 们 想 要 养 成 一 个 新 习惯 ,那么 只 要 把 上 述 旧 习惯 的 回路 中 的 第 1 步 中 的 “暗示 ”和 第 3 步 中 的 “奖赏 ”保留 不 动 ， 然 后 用 一 个 新 的 惯常 行为 替换 掉 
第 2 步 中 旧 的 惯常 行为 ， 那 么 大 脑 就 可 以 在 第 1 步 的 结尾 处 选择 我 们 的 新 习惯 ， 从 而 养 成 这 个 新 的 习惯 。 这 就 是 在 《习惯 的 力量 》 一 书 中 阐明 的 利用 已 经 存在 的 旧 习惯 来 将 其 改变 的 秘密 。 之 所 以 这 样 做 ， 是 
因为 如 果 新 行为 模式 的 开头 和 结尾 存在 一 个 人 所 熟悉 的 东西 ， 那 么 就 能 更 容易 地 说 服 这 个 人 接受 新 的 行为 模式 。 


比如 对 于 TDD 开 发 方法 这 个 新 习惯 ， 我 们 可 以 保留 第 1 步 打开 IDE 准 备 编程 这 个 上 暗示， 和 第 3 步 看 到 符合 预期 的 结果 这 个 奖赏 ， 然 后 把 中 间 先 写生 产 代 码 的 旧 的 惯常 行为 ， 蔡 换 为 TDD 开 发 方法 。 这 样 保 
留 第 1 步 和 第 3 步 ， 我 们 就 可 以 最 大 限度 地 让 程序 员 接受 这 个 新 习惯 。 


既然 我 们 要 在 第 2 步 中 ， 把 原先 旧 的 惯常 行为 蔡 换 为 更 好 的 新 的 惯常 行为 ， 那 么 ， 怎 样 才能 让 新 的 惯常 行为 更 好 ， 甚 至 达到 世界 级 水 平 呢 ? 


Malcolm Gladwell 在 他 写 的 OutliersB] 一 书 中 ， 提 出 了 “10000 小 时 法 则 ” (The 10，000-Hour Rule) 。Gladwell 在 书 中 写 道 : “各 种 研究 表明 ， 为 了 达到 各 种 领域 的 世界 级 专家 的 水 平 ， 需 要 
10000 小 时 的 实践 。 神 经 学 家 Daniel Levitin 这 样 写 道 ，“' 我 们 对 下 面 各 种 专家 进行 了 一 个 又 一 个 的 研究 ， 这 些 专家 包括 作曲 家 、 篮 球 运动 员 、 小 说 家 、 滑 冰 运 动员 、 钢 琴 演 奏 家 、 国 际 象棋 棋 手 、 犯 罪 大 
师 ， 以 及 其 他 您 能 想到 的 专家 ， 我 们 发 现 10000 这 个 数字 一 次 又 一 次 地 出 现 。 当 然 这 并 不 是 解决 为 什么 一 些 人 会 比 其 他 人 能 从 他 们 的 实践 中 获取 更 多 技能 这 个 问题 。 但 是 迄今 为 止 没有 一 个 人 能 够 发 现下 面 
这 种 情况 ， 即 真正 的 世界 级 的 专业 知识 能 够 在 少 于 10000 小 时 的 时 间 内 被 掌握 。 这 看 起 来 似乎 是 大 脑 要 花 10000 小 时 这 样 长 的 时 间 来 消化 所 有 它 需 要 知道 的 东西 ， 来 到 达 真 正 的 精通 程度 。 " 


看 来 ， 如 果 想 让 我 们 新 的 惯常 行为 达到 世界 级 的 专业 水 平 ， 需 要 花 至 少 10000 小 时 来 实践 ， 即 每 天 花 3 小 时 ， 需 要 连续 进行 10 年 的 实践 。 这 提示 我 们 ， 要 形成 更 好 的 新 的 惯常 行为 ， 我 们 需要 长 期 的 实 
践 。 


有 人 会 说 : “既然 实践 10000 小 时 就 能 达到 世界 水 平 ， 那 我 从 小 到 大 走路 的 时 间 都 已 经 超过 10000 小 时 了 ， 为 何 还 不 是 竞走 的 世界 冠军 呢 ?“ 


瑞典 心理 学 家 、 佛 罗 里 达州 立 大 学 心理 学 教授 、 举 世 公认 的 在 “专业 知识 与 技能 ”领域 的 理论 和 试验 领先 的 研究 者 K.Anders Ericsson， 在 他 1993 年 发 表 的 文章 The Role of Deliberate Practice in the 
Acquisition of Expert Performance 中 指出 的 下 面 结论 ， 或 许 能 够 解释 上 面 的 问题 : “人 们 相信 ， 因 为 专业 高 手 的 表现 与 正常 人 的 表现 具有 本 质 的 不 同 ， 所 以 这 些 专业 级 别 的 表演 者 一 定 天 生 就 具有 在 本 质 
上 与 正常 的 成 年 人 完全 不 同 的 豪 风 。 这 一 观点 阻碍 了 科学 家 们 用 一 般 的 心理 学 的 规律 和 原则 ， 对 专业 高 手 进行 系统 考察 ， 并 研究 他 们 的 表现 。 我 们 认同 专业 高 手 的 表现 与 正常 人 的 表现 具有 本 质 的 不 同 ， 我 
们 甚至 认同 专业 高 手 具 备 在 本 质 上 与 正常 的 成 年 人 完全 不 同 的 ， 或 者 至 少 超出 了 正常 成 年 人 范围 的 豪 赋 和 能 力 。 然 而 ， 我 们 否认 由 于 天 生 齐 赋 的 原因 ， 使 得 这 种 不 同一 成 不 变 。 只 有 人 少数 最 极端 的 例外 情况 
是 由 基因 所 决定 的 。 我 们 认为 ， 在 专业 高 手 与 正常 成 年 人 之 间 存 在 的 差异 ， 可 以 用 下 面 一 点 来 反映 出 来 ， 即 是 否 在 某 一 特定 领域 用 一 生 的 时 间 来 刻意 地 完善 自己 的 表现 。” 


Ericsson 在 这 段 有 关 专 业 高 手 的 结论 中 有 3 个 要 点 : 第 一 个 是 “在 某 一 特定 领域 ”， 即 专注 ; 第 二 个 是 “用 一 生 的 时 间 ”， 即 长 期 ; 第 三 个 是 “刻意 地 完善 自己 ”， 即 用 心 。 


专注 、 长 期 和 用 心 这 三 者 要 同时 具备 ， 才 有 可 能 做 好 我 们 新 的 惯常 的 行为 ， 进 而 达到 专业 高 手 的 水 平 。 


我 们 正常 的 成 年 人 天 天 在 走路 ， 但 没有 几 个 能 成 为 竞走 世界 冠军 ， 这 是 因为 我 们 虽然 能 够 做 到 长 期 ， 但 是 我 们 的 主要 精力 会 发 散 到 诸如 上 班 、 照 顾 孩 子 、 娱 乐 等 其 他 事情 上 ， 做 不 到 专注 和 用 心 ， 使 得 
我 们 的 技能 达 不 到 专业 水 平 。 


很 多 人 上 学 时 在 考试 的 压力 下 ， 能 够 专注 和 用 心地 把 外 语 说 得 很 好 ， 可 后 来 到 了 一 家 不 用 外 语 的 单位 工作 几 年 后 ， 由 于 做 不 到 长 期 坚持 ,使 得 以 前 学 到 的 外 语 “ 全 还 给 老师 了 ”。 这 说 明 即 使 我 们 暂时 
能 够 做 到 专注 和 用 心 ， 但 如 果 没有 长 期 坚持 ， 以 前 能 够 做 好 的 惯常 行为 ， 到 后 来 也 会 渐渐 被 我 们 荒废 了 。 


但 是 ， 即 使 专注 、 长 期 和 用 心 这 3 个 要 素 都 具备 了 ， 比 如 像 在 本 章 开 头 的 故事 中 的 凯特 ， 通 过 专门 的 、 长 期 的 和 刻意 的 训练 ， 伪 装 成 德国 人 而 打 入 党 卫 军 内 部 ， 但 是 在 生 孩 子 的 疼痛 这 样 的 外 在 压力 下 ， 
她 养 成 的 说 德语 的 新 习惯 还 是 被 以 前 说 俄语 的 旧 习惯 所 取代 。 那 么 ， 有 没有 可 能 即使 在 外 在 压力 很 大 的 情况 下 ， 把 经 过 新 的 惯常 行为 改造 后 的 习惯 回路 永久 化 呢 ? 


对 于 上 述 问题 ，《 习 惯 的 力量 》 一 书 给 出 的 回答 是 : “信仰 本 身 。” “一 旦 人 们 学 会 信仰 某 种 东西 ， 这 种 信仰 就 会 扩展 到 生活 的 其 他 方面 ， 直 到 他 们 开始 相信 自己 能 改变 。” “大 多 数 彻底 改变 了 自己 
生活 的 人 ， 并 没有 遇 到 意义 重大 的 事件 或 致命 的 灾难 ， 而 仅仅 是 因为 加 入 了 团体 ， 这 个 团体 让 他 们 相信 改变 是 可 能 的 ， 有 时 这 个 团体 即使 只 有 两 个 人 ， 也 会 有 同样 的 效果 。 ” 


这 里 所 说 的 信仰 ， 不 一 定 是 像 宗 教 那样 的 信仰 ， 而 是 指 任何 人 们 所 能 长 期 相信 的 东西 。 下 面 将 描述 的 我 个 人 的 切身 经 历 表明 : 任何 能 够 使 人们 发 生 改 变 的 团体 ， 哪 怕 只 有 两 个 人 ， 都 同样 能 够 帮助 人 们 
识别 和 验证 他 以 前 所 相信 的 东西 ， 进 而 将 其 确定 为 他 的 信仰 ， 并 使 得 他 改变 后 的 新 习惯 永久 化 。 


7 年 前 的 我 ， 尽 管 已 经 37 岁 ， 并 且 工 作 了 14 年 ， 但 还 是 保持 了 我 30 年 前 上 小 学 以 来 养 成 的 老 习惯 : 采 觅 胆 小 ， 缺 乏 自信 ， 说 话 口吃 。 那 时 的 我 ， 即 使 在 熟人 面前 也 不 敢 讲话 ， 更 不 用 说 在 生 人 面前 了 。 


正在 我 为 自己 这 个 令 我 烦恼 的 老 习 惯 发 愁 时 ， 一 位 曾 去 加 拿 大 留学 的 同事 胡 涛 ， 介 绍 我 去 参加 一 个 非 营 利 的 教育 机 构 一 一 国际 演讲 会 一 一 的 一 个 俱乐部 的 会 议 。 当 我 第 一 次 走 进 这 样 的 团体 时 ， 在 会 
议 中 看 到 讲台 上 用 英语 充满 自信 地 侃侃 而 谈 的 演讲 者 ， 听 着 他 们 讲述 自己 如 何在 俱乐部 的 演讲 活动 中 找到 自信 ， 改 变 自己 的 故事 ， 我 被 强烈 地 震撼 了 。 这 正 是 我 所 需要 的 。 很 快 ， 我 就 如 入 了 国际 演讲 会 。 


我 至 今 还 对 我 在 国际 演讲 会 上 的 第 一 次 演讲 记忆 犹 新 。 演 讲 的 头 天 晚上 ， 我 一 夜 未 眠 ， 在 床上 办 转 反 侧 ， 脑 子 里 想 的 全 是 第 二 天 演讲 的 事情 : 在 讲台 上 我 的 手 该 放 在 哪里 ?眼睛 该 看 谁 ? 要 是 忘 词 儿 该 
怎么 办 ? 


第 二 天 ， 我 紧张 万 分 地 上 了 讲台 ， 把 我 在 网 上 找到 的 一 篇 英文 文章 背 完 后 ， 就 低头 


很 快 ， 为 我 做 点 评 的 会 员 Vivian Kong 走 上 讲台 ， 她 竟然 夸 我 的 肢体 语言 做 得 很 好 ， 并 且说 我 的 语音 语调 能 够 有 效 地 烘托 气氛 ， 而 且 在 讲台 上 没有 使 


仔细 按照 国际 演讲 会 的 手册 来 准备 演讲 ， 以 便 讲 得 更 好 。 


Vivian 这 种 既 给 出 表扬 又 提出 建议 


可 到 了 


自己 的 座 


位 。 


很 快 ， 我 也 学 会 了 Vivian 这 种 “表扬 加 建议 ”的 点 评 方式 ， 除 了 自己 做 演讲 ， 也 开始 为 


上 个 月 ， 我 的 俱乐部 负责 教育 的 如 


的 点 评 ， 给 了 我 莫大 的 鼓励 ， 令 我 相信 自己 可 以 发 生 改变 ， 来 做 好 下 一 次 演讲 。 


他 会 员 提供 点 评 。 就 这 样 一 直 参 加 俱乐部 的 会 议 ， 弄 


会 长 Hubert Lin 请 我 做 俱乐部 新 会 员 培训 的 主持 人 。 我 担心 我 的 英语 还 不 够 好 ， 而 且 


自信 和 流畅 。 


讲 英文 ， 我 就 只 好 用 英语 主持 了 俱乐部 新 会 员 的 培训 。 培 训 结束 后 ， 会 员 们 说 我 主持 得 很 
在 20 多 个 人 面前 用 英文 来 主持 培训 ， 而 且 还 担心 自己 英文 不 够 好 ， 这 就 是 一 个 压力 。 而 在 这 个 压力 


部 这 个 团体 给 我 的 信心 ， 让 我 确立 了 


自己 可 以 被 改变 的 信仰。 


顺便 说 一 句 ， 上 个 月 培训 前 的 那天 晚上 ， 我 睡 得 很 好 。 


E, Rt) 
编程 技能 
发 习惯 。 


以 改进 ， 这 一 切 都 给 了 我 


前 两 年 我 的 孩子 学 钢琴 ， 孩 子 的 妈妈 给 他 找 了 一 位 钢琴 老师 来 教 他 ， 这 就 是 钢琴 陪练 。11 生 
生 信心 ， 确 立信 仰 ， 进 而 将 新 学 到 的 习惯 永久 化 。 我 时 常 在 想 ， 编 程 也 像 弹琴 和 开车 那样 ， 是 门 手艺 ， 也 需要 结对 编程 这 样 的 小 团 


将 来 在 国内 会 有 这 样 的 编程 陪练 诞生 呢 。 
再 回 到 本 章 开头 凯特 的 故事 ， 她 之 所 以 在 生 孩 子 的 疼痛 面前 没有 保持 讲 德语 的 新 习惯 ,就 是 
她 的 新 习惯 永久 化 ， 最 终 让 她 的 旧 习 惯 冒 了 出 来 。 


国际 演讲 会 这 个 大 团体 ， 让 我 确立 了 “我 的 演讲 能 力 可 以 被 改变 ”这 个 信仰 。 相 似 地 ， 结 对 编程 这 个 两 人 的 小 团 
场 和 办 软件 重 构 小 组 的 启发 ， 我 也 创办 了 一 个 公益 的 编程 操练 社区 “北京 设计 模式 学 习 组 ”。 我 一 方面 
其 他 的 编程 道场 活动 ， 和 程序 员 结 对 编程 。 无 论 是 我 组 织 的 编程 道场 这 样 的 大 团 
自信 ， 让 我 确立 了 “我 能 够 改善 我 的 编程 技能 ” 


这 个 信和 1 


面前 ， 我 以 前 采 膜 胆 小 的 旧 习惯 没有 跳出 来 ， 


到 会 的 会 员 中 没有 外 国人 ， 所 以 我 想 


如 今 已 经 7 年 了 。 


讲稿 。 她 还 希望 我 下 次 要 把 声音 


放大 一 些 ， 再 


中 文 主持 培训 。 


却 仍然 保持 了 


体 ， 也 让 我 相信 我 的 编程 能 力也 是 可 以 被 改进 的 。2013 
自己 组 织 了 10 多 次 结对 编程 道场 的 活动 ， 在 其 中 分 享 


体 ， 还 是 我 和 另 一 位 程序 员 一 对 一 结对 编程 这 样 的 小 团 


体 ， 每 次 都 能 让 我 学 习 到 
， 使 得 我 在 过 去 的 一 年 中 20 多 次 的 技术 大 会 和 编程 道场 上 的 现场 编程 的 压力 下 ， 始 终 保持 了 新 养 成 的 TDD 的 开 


自信 流畅 的 新 习 


e 
R, 


后 来 会 员 们 


馈 说 都 愿意 


这 归功 于 7 年 来 俱 乐 


F4 月 ， 受 
自己 的 TDD 经 验 并 组 织 大 家 结对 编程 ， 另 一 方 
新 的 技能 和 知识 ， 并 对 


国外 程序 员 做 编程 道 


自己 的 


前 我 学 开 


“天 下 没有 不 散 的 链 席 。” 在 我 们 先 
起 继续 做 了 驯服 诸如 答题 闯关 游戏 Trivia、 
和 亲爱 的 读者 说 再 见 的 时 候 了 。 在 和 您 说 


轮胎 压力 检测 系统 、 


1) 习惯 是 不 能 被 消除 的 ， 而 只 能 被 代替。 


2) 如 果 把 旧 习 惯 的 回路 中 的 第 1 步 中 的 “暗示 ”和 第 3 步 中 的 “奖赏 ”保留 不 动 ， 然 后 


成 这 个 新 的 习惯 。 


3) 如 果 想 让 我 们 新 的 惯常 行为 达到 世界 级 的 专业 水 平 ， 我 们 需要 花 至 


4) 只 有 专注 、 长 期 和 


5) 只 要 我 们 加 入 一 个 能 让 我 们 相信 改变 是 可 能 的 团体 ， 即 使 这 个 团体 只 有 两 个 人 ， 也 能 让 我 们 的 新 习惯 永久 地 固 


最 后 ， 我 给 亲爱 的 读者 的 临别 赠言 是 : 编程 是 门 手 艺 ， 好 的 编程 手艺 就 是 编程 


匠 艺 ， 而 编程 匠 艺 出 


心地 去 做 这 10000 小 时 的 实践 ， 才 有 可 能 让 我 们 新 的 惯常 的 行为 达到 专业 高 手 的 水 平 。 


， 找 了 一 位 师傅 上 路 教 我 ， 这 就 是 驾车 陪练 。 陪 练 中 的 两 个 人 ， 就 是 一 个 小 


因为 她 的 特工 身份 使 得 她 无 法 找 腊 


一 个 新 的 惯常 行为 替换 掉 第 2 步 中 旧 的 惯常 行为 ， 那 么 大 脑 就 可 以 在 第 一 步 的 结 


少 10000 小 时 来 实践 ， 即 每 天 花 3 小 时 ， 连 续 进行 1 


自 专注 、 长 期 和 


U 故事 来 自 莫斯科 电影 制 片 厂 1973 年 出 品 的 电视 剧 《春天 里 的 17 个 肯 间 》， 
[2] Charles Duhigg 著 , RR. Mam, PME, 
[3] Malcolm Gladwell, 


«Outliers:The Story of Success» , Back Bay Books,June 7,2011 


[4] 参见 : www. toastmasters.orge 


编程 操练 ， 即 英文 的 Code Kata， 是 《程序 员 修炼 之 道 : 从 小 工 到 专家 》 ( (The Pragmatic Programmer: From Journeyman to Master) ) 一 书 的 合 著 者 、 美 国 
自身 的 编程 技能 。Kata 是 一 个 日 语 片 假名 从 大 的 英 译 ， 对 应 的 汉字 是 “型 ”或 者 “ 形 ” ， 表 示 供 生 


后 创造 的 字眼 ， 表 示 一 个 编程 练习 ， 程 序 员 可 以 通过 
仔细 编排 的 动作 模式 中 ]。 


复 地 操练 该 练习 来 提高 


附录 A ”编程 操练 简介 


演员 练习 压 腿 和 踢 腿 ， 相 声 演员 练习 绕口令 和 开 声 ， 和 习 武 之 人 的 独 


编程 操练 ， 说 白 了 其 实 就 是 程序 员 练 功 时 对 一 个 编程 题目 进行 练习 。 说 起 练功 ， 可 以 很 自然 地 联想 到 京剧 
与 之 相 比 ， 程 序 员 的 练功 似乎 就 没有 那么 讲究 。 自 20 世 纪 80 年 代 面 向 对 象 的 编程 语言 出 现 以 来 至 今 ， 这 30 多 年 的 时 间 里 ， 国 


多 再 照 着 示例 代码 写 一 些 程序 ， 运 行 一 下 而 已 。 即 使 在 程序 员 编 程 水 平 很 高 的 国外 
里 的 “编程 道场 ”是 英文 coding dojo 的 中 译 ， 其 中 的 dojo 同 样 也 来 


， 直 到 2004: 


编程 道场 意 指 多 位 程序 员 聚 在 一 起 ， 用 两 人 结对 或 
retreat) 的 新 形式 ， 即 几 十 个 程序 员 聚 在 一 起 ， 上 
序 员 Mike Long 于 2011 年 12 月 3 日 ， 在 北京 发 起 了 “编程 静 修 全 球 日 
有 幸 参 加 了 其 中 2012 


(G 


既然 编程 操练 是 供 程序 员 在 没有 工作 压力 的 情况 下 练功 时 所 使 


F5 月 ， 法 


团 


体 ， 会 让 学 习 者 产 


体 来 建立 信仰 ， 把 新 的 编程 习惯 永久 化 ， 但 为 何 见 不 到 


一 个 能 帮助 她 建立 信心 改变 


F 的 实践 。 


化 下 来 ， 并 杜绝 旧 习 惯 的 复发 。 
心 的 结对 编程 操练 。 希 望 咱们 能 有 机 会 结对 编程 ， 共 同 成 为 编程 艺 


参考 了 《 冬 吴 相对 论 》 第 427 期 “习惯 的 力量 ”和 百度 百科 。 
《习惯 的 力量 》， 中 信 出 版 社 ，2013 年 4 月 ， 第 1 版 。 


人 演示 的 形式 ， 来 做 编程 操练 的 过 程 。 编 程 操练 和 编程 道场 在 国外 已 经 发 展 了 近 10 年 ， 
一 整 天 的 时 间 来 在 编程 道场 中 轮流 结对 做 编程 操练 。 编 程 操练 、 编 程 道场 和 编程 静 修 这 几 年 在 | 


甘 


HI 


obal Day of CoderetreatB]) 北京 站 的 活动 ， 


编程 陪练 呢 ? 或 许 


自己 习惯 的 团体 ， 进 而 形成 不 了 信仰 ， 不 能 让 


传统 的 设计 驱动 的 开发 方法 和 TDD 的 开发 方法 从 零 开 始 做 了 酒店 世界 时 钟 的 结对 编程 操练 后 ， 我 们 一 起 讨论 了 测试 后 行 与 测试 先行 的 对 比 ， 定 义 了 烂 代码 ， 又 一 
动 取 号 系统 和 网 页 文本 转换 系统 这 些 已 有 的 烂 代码 的 结对 编程 操练 ， 最 后 一 起 讨论 了 驯服 烂 代码 的 步骤 和 习惯 的 养 成 方法 。 现 在 终于 到 了 要 
临别 赠 言 之 前 ， 让 我 们 回顾 一 下 本 章 的 内 容 : 


尾 处 选择 我 们 的 新 习惯 ， 从 而 养 


al 


程序 员 Dave Thomas 在 2003 年 前 
和 人 或 双人 进行 操练 的 、 经 过 


自 站 桩 和 与 人 过 招 切磋 。 
内 的 绝 大 部 分 程序 员 的 所 谓 “练功 ”， 仅 仅 停 留 在 读 一 些 技术 书籍 和 博客 上 ， 
国 程序 员 Laurent Bossavit 才 写 了 一 篇 有 关 多 位 程序 员 在 一 起 做 编程 操练 的 “编程 道场 ”的 博客 。 这 
语 ， 是 片 假名 点 5 * 3 的 英 译 ， 对 应 的 汉字 是 “道场 ”， 指 一 个 正式 的 训练 场所 ， 来 供 学 习 


BX 


本 武术 的 学 生 聚 在 一 起 进行 操 


影响 力 不 断 扩大 ， 到 2009 年 又 出 现 了 编程 静 修 [2] (code 
内 也 陆续 得 到 一 些 发 展 ， 比 如 出 生 于 澳大利亚 墨尔本 的 程 


从 那 以 后 到 撰写 本 书 时 ，Mike 每 年 12 月 都 在 北京 举办 一 次 编程 静 修 的 活动 。 笔 者 


和 2013 年 的 活动 。 另 外 ， 在 撰写 本 书 时 ， 笔 者 受 《 重 构 与 模式 》 (《Refactoring to Patterns) 


一 书 的 作者 Joshua Kerievsky 于 1995 年 在 美国 纽约 创办 设计 模式 学 习 小 组 的 启 
发 ， 于 2013 年 4 月 在 北京 创办 了 “bjdp.org 北 京 设计 模式 学 习 组 ”， 到 撰写 本 书 时 ， 已 举办 18 次 活动 ， 每 次 能 吸引 8~20 位 程序 员 来 进行 结对 操练 编程 技艺 。 这 一 切 似乎 都 在 表明 ， 编 写 程序 不 再 仅 是 按照 既 
定 的 软件 架构 或 框架 ， 来 像 侄 砖 那样 被 动 地 “ 填 ” 代 码 ， 而 是 像 唱 京戏 、 说 相声 、 练 武术 那样 ， 更 加 强调 人 的 创造 性 ， 是 一 门 需要 反复 操练 才能 悟道 出 师 的 手艺 。 


的 ， 为 了 能 够 让 程序 员 们 在 操练 时 获得 更 有 趣 的 体验 ， 编 程 操练 需要 设计 得 “有 趣 ”， 即 除了 题目 的 内 容 可 以 是 生活 中 有 意思 的 场景 


外 ， 


最 好 还 能 通过 实现 这 个 操练 ， 练 习 一 些 有 挑战 性 的 技能 ， 比 如 结对 编程 和 设计 模式 。 


[0] 参见 : hetp://en.wikipedia.org/wiki/Kata. 
D] 感谢 来 自 上 海 的 软件 开发 咨询 师 姚 若 舟 向 笔者 建议 “ 静 修 ”这 个 译 法 。 
[3] 参见 : http://globalday.coderetreat.org/ 。 


附录 B 怎样 在 Windows 系 统 中 搭建 编程 操练 环境 


下 面 以 Windows 7 简体 中 文 版 (x64 位 版 为 例 来 说 明 如 何在 Windows 系 统 中 搭建 编程 操练 环境 。 


1) 下 载 [1 并 安装 JDK 8 (Java SE 8u20) 。 


运行 下 载 的 安装 文件 dk-8u20-windows-x64.exe。 在 安装 JDK 8 过 程 中 ， 将 JDK 1.8 安 装 在 目录 C:\Program Files\Java\jdk1.8.0 20 下， 将 JRE 1.8 安 装 在 目录 C:\Program FilesNWavaNjre1.8.0 20 下 。 


2) 下 载 巴 并 解压 Maven (Apache Maven 3.2.3) 。 


将 下 载 下 来 的 Maven 的 ZIP 文 件 解 压 到 目录 C:\Program Files (x86) \apache-maven-3.2.3 下 。 


3) 能 在 命令 行 上 运行 Maven。 


首先 配置 环境 变量 ， 新 建 JAVA_HOME 和 M3_HOME 环 境 变量 ， 分 别 指向 JDK 和 Maven 的 安装 目录 ， 然 后 修改 Path 环 境 变量 ， 添 加 上 面 两 个 安装 目录 下 的 bin 目 录 ， 使 得 能 在 命令 行 上 运行 bin 目 录 下 的 


=> 
2 


录 。 


H, 


新 建 环境 变量 的 方法 : 控制 面板 一 查找 env 一 选择 “编辑 系统 环境 变量 ”一 系统 变量 一 新 建 。 


新 建 环境 变量 JAVA_HOME 为 C:\Program Files\Java\jdk1.8.0_20, 


再 新 建 环境 变量 M3_HOME 为 C:\Program Files (x86) \apache-maven-3.2.3。 


修改 环境 变量 PATH， 在 其 值 前 面 添加 字符 串 “%JAVA_HOME%\bin; %M3_HOME%\bin; ”。 


打开 一 个 命令 行 窗口 ， 运 行 命令 “mvn -v”。 如 果 能 看 到 类 型 下 面 的 输出 ， 就 表示 JDK 和 Maven 已 经 安装 完成 。 


Apache Maven 3.2.3 (33£8c3e1027c3ddde99d3cdebad2656a31le8fdf4; 2014-08-12T04:58:1 
0+08:00) 

Maven home: C:\Program Files (x86) \apache-maven-3.2.3 

Java version: 1.8.0 20, vendor: Oracle Corporation 

Java home: C:\Program Files\Java\jdk1.8.0_20\jre 

Default locale: zh_CN, platform encoding: GBK 

OS name: “windows 7", version: "6.1", arch: "amd64", family: "dos" 


4) 下 载 B] 并 安装 Git (Git-1.9.4-preview20140815) 。 


运行 下 载 的 Git 的 EXE 文 件 ， 将 其 安装 在 C:\Program Files (x86) \Git 目 录 下 。 


在 Git 安 装 过 程 中 ， 勾 选 On the Desktop 选 项 。 这 样 安装 完毕 后 ，Git Bash 命 令 行 工具 就 能 出 现在 桌面 上 。 


5) 从 GitHub 上 复制 源 代 码 。 


打开 Git Bash 命 令 行 工具 ， 运 行 “cd” 命 令 ， 进 入 当前 用 户 的 home 目 录 (以 /CUsers/ben 为 例 ) 。 再 运行 “mkdir katas” 命 令 ， 在 当前 目录 下 创建 目录 katas。 然 后 运行 “cd katas” 命 令 进入 该 目 


打开 一 个 浏览 器 ， 访 问 https://github.com/wubin28/tbc-ticket-dispenser-java.git 页 面 ， 该 页 面 显 示 了 本 书 第 17 章 中 有 关 Mock 的 编程 操练 的 题目 源 代码 。 在 页 面 左上 侧 ， 单 击 branch: master 按 
能 显示 一 个 下 拉 菜 单 ， 内 有 这 个 编程 操练 题目 的 一 些 分 支 (branch) 。 其 中 ，exercise 分 支 是 该 编程 题目 的 原 题 ，subclass-and-override-method 分 支 是 第 17 章 中 介绍 的 有 关 这 个 题目 的 解决 方案 。 


选择 相应 的 分 支 ， 再 单 击 上 面 的 nn commits， 就 能 在 页 面 上 浏览 历次 提交 的 代码 。 


下 面 要 把 GitHub 上 的 源 代码 从 网 上 复制 到 本 地 ， 再 用 Intellij 1DEA 来 编写 并 运行 代码 。 


单 击 页 面 中 下 方 右 侧 HTTPS clone URL 右 下 方 的 “Copy to clipboard” 按 钮 ， 将 代码 URL 复 制 到 剪贴 板 上 。 


然后 回 到 Git Bash 命 令 行 工具 窗口 中 ， 输 入 命令 “git clone”， 并 选用 该 命令 行 窗口 左上 角 的 相应 菜单 将 刚刚 复制 的 URL 粘 贴 到 命令 行 中 ， 最 终 命 令 如 下 所 示 : 


git clone https://github.com/wubin28/tbc-ticket-dispenser-java.git 


按 回 车 运行 该 命令 后 ， 如 果 命 令 行 有 类 似 下 面 的 输出 ， 则 表示 代码 从 网 上 成 功 复制 到 本 地 。 


Cloning into 'tbc-ticket-dispenser-java'http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/14950/OEBPS/Text/... 
remote: Counting objects: 1167, done. T 

remote: Total 1167 (delta 0), reused 0 (delta 0) 

Receiving objects: 100% (1167/1167), 81.84 KiB | 68.00 KiB/s, done. 

Resolving deltas: 100% (342/342), done. 

Checking connectivityhttp: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/14950/OEBPS/Text/... done. 


此 时 ， 运 行 “cd tbcrticket-dispenser-java” 命 令 ， 进 入 刚刚 创建 的 目录 。 运 行 “git branch” 命 令 显示 本 地 的 分 支 ， 应 该 只 能 看 到 master 分 支 。 


6) 将 exercise 分 支 从 网 上 复制 到 本 地 。 


接着 运行 “git branch -a” 命 令 显示 所 有 的 分 支 ， 如 下 所 示 : 


* master 
remotes/origin/HEAD -> origin/master 
remotes/origin/bjdp-18-jd 


remotes/origin/exercise 
remotes/origin/extract-interface 
remotes/origin/master 
remotes/origin/subclass-—and-override-method 
remotes/origin/using-mockito 
remotes/origin/using-mockito-error-fixing-oriented 


此 时 可 以 看 到 remotes/origin/exercise 分 支 是 红色 的 ， 表 示 它 还 在 网 上 ， 没 有 被 复制 到 本 地 。 


运行 下 面 的 命令 ,将 exercise 分 支 从 网 上 复制 到 本 地 ， 并 将 当前 分 支 切换 为 该 分 支 。 


git checkout -b exercise origin/exercise 


如 果 命令 运行 成 功 ,会 有 类 似 下 面 的 输出 : 


Branch exercise set up to track remote branch exercise from origin. 
Switched to a new branch 'exercise' 


此 时 运行 命令 “git branch” ， 会 有 下 面 的 输出 : 


$ git branch 
* exercise 
master 


这 里 exercise 左 边 有 一 个 星 号 ， 表 示 它 是 当前 的 分 支 。 


7) 下 载 由 并 安装 Intellij IDEA 集 成 开发 环境 Community 版 (idealC-13.1.4b) 。 


运行 下 载 的 IDEA 的 EXE 安 装 文件 ， 将 软件 安装 到 目录 C:\Program Files (x86) \JetBrains\IntelliJ IDEA Community Edition 13.1.4 下 。 


打开 IDEA， 在 Quick Start 窗 口中 选择 Open Project， 然 后 打开 下 面 的 pom.xml 文 件 。 


C:\Users\ben\katas\tbc-ticket-dispenser-java\td\pom. xml 


此 时 ， 在 IDEA 底 部 的 状态 条 中 会 显示 “Downloading plugins for tdhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/14950/OEBPS/VText/…”， 表 示 IDEA 正 在 下 载 插件 。 待 其 消失 后 ， 表 示 IDEA 已 经 安装 好 了 。 


8) 用 IDEA 运 行 exercise 分 支 中 的 测试 类 。 


将 光标 定位 到 左上 部 的 Project 窗 口中 文件 夹 td/src/test/java/kata.td 下 的 TicketDispenser-Test 类 ， 然 后 按 快捷 键 Ctrl+ Shift+F10 来 运行 这 个 测试 类 。 


此 时 会 显示 一 个 对 话 框 ， 显 示 如 下 错误 : 


Error: Cannot start compiler: the SDK is not specified for module "td". Specify 
the SDK at Project Structure dialog. 


个 错误 表示 JDK 还 未 在 IDEA 中 配置 好 。 单 击 该 对 话 框 中 的 OK 按钮 后 ， 就 会 出 现 Project Structure 对 话 框 。 其 中 Module SDK: 右边 显示 <No Project SDK>， 表 示 JDK 未 配 好 。 单 
击 aaah ee a a 按钮 ， 出 现 Set up Module SDK 下 拉 菜 单 。 从 中 选择 JDK。 再 
选择 JDK 的 Home Directory 为 C:\Program Files\Java\jdk1.8.0 20。 单 击 OK 按 钮 。 当 出 现 “Set up created SDK on project? ”时 ， 选 择 Yes。 然 后 单 击 OK 按钮 。 


然后 再 次 将 光标 定位 到 左上 部 的 Project 窗 口中 td/src/test/java/kata.td 文 件 夹 下 的 TicketDispenserTest 类 ， 然 后 按 快捷 键 Ctrl+ Shift+F10， 来 运行 这 个 测试 类 。 


此 时 IDEA 底 部 的 状态 条 会 显示 一 个 旋转 的 光标 ， 表 示 正 在 编译 运行 该 测试 类 。 等 运行 完毕 后 ， 在 中 下 方 会 出 现 测试 运行 成 功 的 绿 条 。 现 在 就 可 以 在 !IDEA 里 的 这 个 编程 操练 题目 的 原 题 上 进行 编程 了 。 


9) 根据 代码 提交 的 Commit Message (CM) 来 使 用 Git 阅 读 subclass-and-override-method 分 支 中 的 代码 。 


下 面 来 说 明 如 何 根据 本 书 每 段 示 例 代 码 前 所 标 出 的 CM 来 使 用 Git 阅 读 代码 。 比 如 现在 想 将 代码 恢复 到 书 中 所 标 出 的 CM 的 状态 , 即 CM: Added TODO: Depending on a static method violates the 


Dependency Inversion Principle and Open-Closed Principle。 


先 运 行 下 面 的 命令 将 subclass-and-override-method 分 支 从 网 上 复制 到 本 地 ， 并 将 其 设置 为 当前 分 支 。 


git checkout -b subclass-and-override-method origin/subclass-and-override-method 


执行 命令 “git branch”， 应 该 可 以 看 到 下 面 的 输出 : 


exercise 
master 
* subclass-and-override-method 


此 时 可 以 运行 命令 “git log” 来 查看 以 往 提 交 的 所 有 CM。 再 运行 “git log> git-log-subclass-and-override-method.txt” 命 令 ， 将 以 往 所 有 的 CM 提交 记录 都 保存 到 一 个 TXT 文 件 中 。 


一 个 文本 编辑 器 打开 这 个 TXT 文 件 ， 查 找 “CM: Added TODO: Depending on a static method violates the Dependency Inversion Principle and Open-Closed Principle.”， 找 到 该 字符 串 
所 在 行 上 方 的 一 长 串 字 母 数字 组 成 的 SHA1 值 : da169b7dbb5ce15ebe5c31a91a5b3403b6b5b445。 将 该 值 复制 下 来 。 


然后 运行 “git reset --hard da169b7dbb5ce15ebe5c31a91a5b3403b6b5b445” 命 令 。 此 时 能 看 到 类 似 下 面 这 样 的 输出 : 


HEAD is now at dal69b7 Added TODO: Depending on a static method violates the 
Dependency Inversion Principle and Open-Closed Principle. 


最 后 运行 “gitk & ”命令 ， 能 够 看 到 一 个 图 形 化 的 Git 工 具 。 从 中 能 够 直观 地 看 到 本 次 提交 下 代码 的 变化 。 


切换 到 IDEA， 能 看 到 其 中 的 代码 也 相应 地 发 生 了 变化 ， 反 映 出 当前 这 个 CM 的 代码 状态 。 


[1] JDK 8 下 载 地 址 : http://www.oracle.com/technetwork/es/java/javase/downloads /index.html . 


[2] Maven 3 下 载 地 址 : http://maven.apache.org/download.cgi。 
[B] Git 下 载 地 址 : http://www.git-scm.com/downloads。 
[4 IntelliJ IDEA 下 载 地 址 : http://www.jetbrains.com/idea/download/。 


附录 C 怎样 在 OS X 系 统 中 搭建 编程 操练 环境 


FALOS X 10.9.4 版 为 例 来 说 明 如 何在 Mac OS X 系 统 中 搭建 编程 操练 环境 。 


1) 下 载 中 并 安装 JDK 8 (Java SE 8u11) 。 


在 Finder 的 Downloads 文 件 夹 中 ， 选 中 下 载 的 文件 dk-8u11-macosx-x64.dmg， 然 后 按 Command+O 快 捷 键 来 打开 这 个 文件 ， 并 进行 安装 。 


2) 用 Homebrew[2 来 安装 Maven (Apache Maven 3.2.2) 。 


复制 到 ji 窗口 中 ， 来 安装 Homebrew。 


EN 
x 
aq 


=> 
“> 


中 输入 terminal， 来 打 个 命令 行 窗口 。 将 下 述 f 


首先 按 快 捷 键 Ctrl+Command+Space， 打 开 右上 角 Spotlight 输 入 框 。 在 : 


Ai 


X 


ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)" 


接 下 来 运行 命令 “brew install mave” ， 来 安装 Maven。 


在 命令 行 窗口 运行 命令 “mvn -V”。 如 果 能 看 到 类 型 下 面 的 输出 ， 就 表示 JDK 和 Maven 已 经 安装 完成 。 


Apache Maven 3.2.2 (45f7c06dq68e745d05611f7fdl4efb6594181933ey 2014-06-17T21:51:42+08:00) 
Maven home: /usr/local/Cellar/maven/3.2.2/libexec 

Java version: 1.8.0_11, vendor: Oracle Corporation 

Java home: /Library/Java/JavaVirtualMachines/jdk1.8.0_11.jdk/Contents/Home/jre 

Default locale: en_US, platform encoding: UTF-8 

OS name: "mac os x", version: "10.9.4", arch: "x86_64", family: "mac" 


4) 下 载 B] 并 安装 Git (git-2.0.1-intel-universal-snow-leopard) 。 
运行 下 载 的 Git 的 DMG 文 件 git-2.0.1-intel-universal-snow-leopard.dmg 进 行 安装 。 


将 下 面 一 行 添加 到 文件 /etc/paths 的 头 部 : 


/usr/local/git/bin 


在 命令 行 上 运行 命令 “git -version”， 能 看 到 类 似 下 


这 样 的 输出 : 


四 


git version 2.0.1 


5) 从 GitHub 上 克隆 源 代码 。 


在 命令 行 窗口 中 ， 运 行 “cd” 命 令 ， 进 入 当前 用 户 的 home 目 录 (以 /Users/ben 为 例 ) 。 再 运行 “mkdir katas” 命 令 ， 在 当前 目录 下 创建 目录 katas。 然 后 运行 “cd katas” 命 令 进 入 该 目录 。 


打开 一 个 浏览 器 ， 访 问 https://github.com/wubin28V/tbc-ticket-dispenser-java.git 页 面 ， 该 页 面 显示 了 本 书 第 17 章 中 有 关 Meock 的 编程 操练 的 题目 源 代码 。 在 页 面 左上 侧 ， 单 击 “branch : 
master” 按 钮 ， 能 显示 一 个 下 拉 菜单 ， 内 有 这 个 编程 操练 题目 的 一 些 分 支 (branch) 。 其 中 ，exercise 分 支 是 该 编程 题目 的 原 题 ，subclass-and-override-method 分 支 是 第 17 章 中 介绍 的 有 关 这 个 题目 的 
解决 方案 。 选 择 相应 的 分 支 ， 再 单 击 上 面 的 nn commits， 就 能 在 页 面 上 浏览 历次 提交 的 代码 。 


E 


下 面 要 把 GitHub 上 的 源 代 码 从 网 上 复制 到 本 地 ， 再 用 Intellij 1DEA 来 编写 并 运行 代码 。 


iy 


a 击 页 面 中 下 方 右 侧 HTTPS clone URL 右 下 方 的 “Copy to clipboard” 按 钮 ， 将 代码 URL 复 制 到 剪贴 板 上 。 


然后 回 到 命令 行 窗 口中 ， 敲 入 命令 “git clone” ， 并 用 快捷 键 Command+V 将 刚刚 复制 的 URL 粘 贴 到 命令 行 中 ， 最 终 命令 如 下 所 示 : 


git clone https://github.com/wubin28/tbc-ticket-dispenser—java.git 


按 回 车 运行 该 命令 后 ， 如 果 命 令 行 有 类 似 下 面 的 输出 ， 则 表示 代码 从 网 上 成 功 复制 到 本 地 。 


Cloning into 'tbc-ticket-dispenser-java'http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/14950/OEBPS/Text/... 
remote: Counting objects: 1167, done. E 

remote: Total 1167 (delta 0), reused 0 (delta 0) 

Receiving objects: 100% (1167/1167), 81.84 KiB | 68.00 KiB/s, done. 

Resolving deltas: 100% (342/342), done. 

Checking connectivityhttp://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/14950/OEBPS/Text/... done. 


此 时 ， 运 行 “cd tbc-ticket-dispenser-java" 命令， 进入 刚刚 创建 的 目录 。 运 行 “git branch” 命令 显示 本 地 的 分 支 ， 应 该 只 能 看 到 master 分 支 。 


6) 将 exercise 分 支 从 网 上 复制 到 本 地 。 


接着 运行 “git branch -a” 命令 显示 所 有 的 分 支 ， 如 下 所 示 : 


* master 
remotes/origin/HEAD -> origin/master 
remotes/origin/bjdp-18-jd 
remotes/origin/exercise 
remotes/origin/extract-interface 
remotes/origin/master 
remotes/origin/subclass-and-override-method 
remotes/origin/using-mockito 


remotes/origin/using-mockito-error-fixing-oriented 


此 时 可 以 看 到 remotes/origin/exercise 分 支 是 红色 的 ， 表 示 它 还 在 网 上 ， 没 有 被 复制 到 本 地 。 


运行 下 面 的 命令 ,将 exercise 分 支 从 网 上 复制 到 本 地 ， 并 将 当前 分 支 切 换 为 该 分 支 。 


git checkout -b exercise origin/exercise 


如 果 命令 运行 成 功 ,会 有 类 似 下 面 的 输出 : 


Branch exercise set up to track remote branch exercise from origin. 
Switched to a new branch 'exercise' 


此 时 运行 “git branch" 命令 ， 会 有 下 面 的 输出 : 


$ git branch 
* exercise 
master 


这 里 exercise 左 边 有 一 个 星 号 ， 表 示 它 是 当前 的 分 支 。 


7) 下 载 负 并 安装 Intellj IDEA 集 成 开发 环境 Community 版 (idealC-13.1.4b) 。 


运行 下 载 的 IDEA 的 DMG 安 装 文件 idealC-13.1.4b.dmg 进 行 安装 。 


打开 IDEA， 在 Open 窗 口中 打开 下 面 的 pom.xml 文 件 。 


/ Users / ben / katas / tbc-ticket-dispenser-java / td / pom.xml 


此 时 ， 在 IDEA 底 部 的 状态 条 中 会 显示 “Downloading plugins for tdhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/14950/OEBPS/Text/…”， 表 示 IDEA 正 在 下 载 插件 。 待 其 消失 后 ， 表 示 IDEA 已 经 安装 好 了 。 


8) 用 IDEA 运 行 exercise 分 支 中 的 测试 类 。 


将 光标 定位 到 左上 部 的 Project 窗 口中 文件 夹 td/src/test/java/kata.td 下 的 TicketDispenser-Test 类 ， 然 后 按 快捷 键 Ctrl+ Shift+F10 来 运行 这 个 测试 类 。 


此 时 会 显示 一 个 对 话 框 ， 显 示 如 下 错误 : 


Error: Cannot start compiler: the SDK is not specified for module "td". Specify 
the SDK at Project Structure dialog. 


这 个 错误 表示 JDK 还 未 在 IDEA 中 配置 好 。 单 击 该 对 话 框 中 的 OK 按钮 后 ， 就 会 出 现 Project Structure 对 话 框 。 其 中 Module SDK: 右边 显示 <No Project SDK> ， 表 示 JDK 未 配 好 。 单 
击 “Newhttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14950/OEBPS/Text/...” 按 钮 ， 出 现 Set up Module SDK 下 拉 菜 单 。 从 中 选择 JDK。 再 
选择 JDK 的 Home Directory 为 /Library/Java/JavaVirtualMachines/jdk1.8.0_11.jdk/Contents/Home。 单 击 OK 按钮 。 当 出 现 “Set up created SDK on project? ”时 ， 选 择 Yes。 然 后 单 击 OK 按钮 。 


然后 再 次 将 光标 定位 到 左上 部 的 Project 窗 口中 td/src/test/java/kata.td 文 件 夹 下 的 TicketDispenserTest 类 ， 然 后 按 快捷 键 Ctrl+ Shift+F10， 来 运行 这 个 测试 类 。 


此 时 IDEA 底 部 的 状态 条 会 显示 一 个 旋转 的 光标 ， 表 示 正 在 编译 运行 该 测试 类 。 等 运行 完毕 后 ， 在 中 下 方 会 出 现 测试 运行 成 功 的 绿 条 。 现 在 就 可 以 在 !IDEA 里 的 这 个 编程 操练 题目 的 原 题 上 进行 编程 了 。 


9) 根据 代码 提交 的 Commit Message (CM) 来 使 用 Git 阅 读 subclass-and-override-method 分 支 中 的 代码 。 


下 面 来 说 明 如 何 根据 本 书 每 段 示 例 代 码 前 所 标 出 的 CM 来 使 用 Git 阅 读 代码 。 比 如 现在 想 将 代码 恢复 到 书 中 所 标 出 的 CM 的 状态 , 即 CM: Added TODO: Depending on a static method violates the 


Dependency Inversion Principle and Open-Closed Principle. 


先 运 行 下 面 的 命令 将 subclass-and-override-method 分 支 从 网 上 复制 到 本 地 ， 并 将 其 设置 为 当前 分 支 。 


a 


git checkout -b subclass-and-override-method origin/subclass-and-override-method 


执行 命令 “git branch” ， 应 该 可 以 看 到 下 面 的 输出 : 


exercise 
master 
* subclass-and-override-method 


此 时 可 以 运行 命令 “git log” 来 查看 以 往 提交 的 所 有 CM。 再 运行 “git log> git-log-subclass-and-override-method.txt” 命 令 ， 将 以 往 所 有 的 CM 提交 记录 都 保存 到 一 个 TXT 文 件 中 。 


Tit 


一 个 文本 编辑 器 打开 这 个 TXT 文件 ， 查 找 “CM: Added TODO: Depending on a static method violates the Dependency Inversion Principle and Open-Closed Principle.”， 找 到 该 字符 
所 在 的 行 的 上 方 的 一 长 串 字母 数字 组 成 的 SHA1 值 : da169b7dbb5ce15ebe5c31a91a5b3403b6b5b445。 将 该 值 复制 下 来 。 


然后 运行 命令 “git reset --hard da169b7dbb5ce15ebe5c31a91a5b3403b6b5b445”。 此 时 能 看 到 类 似 下 面 这 样 的 输出 : 


HEAD is now at dal69b7 Added TODO: Depending on a static method violates the 
Dependency Inversion Principle and Open-Closed Principle. 


最 后 运行 “gitk & ”命令 ， 能 够 看 到 一 个 图 形 化 的 Git 工 具 。 从 中 能 够 直观 地 看 到 本 次 提交 下 代码 的 变化 。 


切换 到 IDEA， 能 看 到 其 中 的 代码 也 相应 地 发 生 了 变化 ， 反 应 出 当前 这 个 CM 的 代码 状态 。 


[JDK 8 下 载 地 址 : http://www.oracle.com/technetwork/es/java/javase/downloads/index.html。 


[2] Homebrew ZOS 又 系统 下 的 一 个 软件 包 管 理工 具 ， 参 见 : http://brew.sh。 


[B] Git 下 载 地 址 : http://www.git-scm.com/download/mac。 


[4 IntelliJ IDEA 下 载 地 址 : http://www.jetbrains.com/idea/download/. 


附录 D 怎样 在 Linux 系 统 中 搭建 编程 操练 环境 


下 面 以 Ubuntu 14.04.1 版 为 例 来 说 明 如 何在 Linux 系 统 中 搭建 编程 操练 环境 。 


1) 下 载 [并 安装 JDK 8 (Java SE 8u5) 。 


在 Terminal 命 令 行 窗 口中 ， 用 管理 员 的 权限 将 下 载 下 来 的 安装 文件 dk-8u5-linux-i586.tar.gz 复 制 到 /opt 目 录 下 。 然 后 运行 “sudo tar xvzf jdk-8u5-linux-i586.tar.gz” 命 令 将 该 文件 解压 到 该 目录 
下 。 


2) 下 载 并 安装 Maven (Apache Maven 3.2.1) 。 


在 Terminal 命 令 行 窗 口中 ， 用 管理 员 的 权限 ， 将 下 载 下 来 的 安装 文件 apache-maven-3.2.1-bin.tar.gz 复 制 到 /opt 目 录 下 。 然 后 运行 “sudo tar xvzf apache-maven-3.2.1-bin.tar.gz” 命 令 将 该 文件 
解压 到 该 目录 下 。 


打开 文件 ~/.bashrc， 在 文件 结尾 处 添加 下 面 几 行 : 


JAVA_HOME=/opt/jdk1.8.0_05; export JAVA HOME 
M3_HOME=/opt/apache-maven-3.2.1; export M3_HOME 
PATH=$. JAVA_HOME/bin :$M3_ HOME, /bin:$PATH; export PATH 


重新 打开 一 个 命令 行 窗口 ， 运 行 “mvn -v” 命 令 。 如 果 能 看 到 类 型 下 面 的 输出 ， 就 表示 JDK 和 Maven 已 经 安装 完成 。 


Apache Maven 3.2.1 (ea8b2b07643dbb1b84b6d1 6e1£08391b666bcle9; 2014-02-15T01:37:52+08:00) 
Maven home: /opt/apache-maven-3.2.1 

Java version: 1.8.0 05, vendor: Oracle Corporation 

Java home: /opt/jdkI.8.0_05/jre 

Default locale: en_US, platform encoding: UTF-8 

OS name: "linux", version: "3.13.0-32-generic", arch: "i386", family: "unix" 


4) 下 载 四 并 安装 Git (git 1.9.1) 。 


Rt 


命令 行 窗口 中 运行 “apt-get install git” 命 令 来 进行 安装 。 


在 命令 行 上 运行 “git -version” 命 令 ， 能 看 到 类 似 下 面 这 样 的 输出 : 


git version 1.9.1 


5) 从 GitHub 上 复制 源 代 码 。 


在 命令 行 窗 口中 ， 运 行 “cd” 命 令 ， 进 入 当前 用 户 的 home 目 录 (以 /home/ben 为 例 ) 。 再 运行 “mkdir katas” 命 令 ， 在 当前 目录 下 创建 目录 “katas”。 然 后 运行 “cd katas” 命 令 进 入 该 目录 。 


打开 一 个 浏览 器 ,访问 https://github.com/wubin28/tbc-ticket-dispenser-java.git 页 面 ， 该 页 面 显示 了 本 书 第 17 章 中 有 关 Mock 的 编程 操练 的 题目 源 代码 。 在 页 面 左 上 侧 ， 单 击 “branch: 
master” 按 钮 ， 能 显示 一 个 下 拉 菜 单 ， 内 有 这 个 编程 操练 题目 的 一 些 分 支 (branch) 。 其 中 ，exercise 分 支 是 该 编程 题目 的 原 题 ，subclass-and-override-method 分 支 是 第 17 章 中 介绍 的 有 关 这 个 题目 的 
解决 方案 。 选 择 相应 的 分 支 ， 再 单 击 上 面 的 nn commits， 就 能 在 页 面 上 浏览 历次 提交 的 代码 。 


E 


下 面 要 把 GitHub 上 的 源 代码 从 网 上 复制 到 本 地 ， 再 用 Intellj 1DEA 来 编写 并 运行 代码 。 


In 


a 击 页 面 中 下 方 右 侧 HTTPS clone URL 右 下 方 的 “Copy to clipboard” 按 钮 ， 将 代码 URL 复 制 到 剪贴 板 上 。 


然后 回 到 命令 行 窗口 中 ， 输 入 “git clone” 命 令 ， 并 用 快捷 键 Shift+ Ctrl+V 将 刚刚 复制 的 URL 粘 贴 到 命令 行 中 ， 最 终 命 令 如 下 所 示 : 


git clone https://github.com/wubin28/tbc-ticket-dispenser-java.git 


按 回 车 运行 该 命令 后 ， 如 果 命 令 行 有 类 似 下 面 的 输出 ， 则 表示 代码 从 网 上 成 功 复制 到 本 地 。 


Cloning into 'tbc-ticket-dispenser-java'http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14950/0EBPS/Text/... 
remote: Counting objects: 1167, done. 

remote: Total 1167 (delta 0), reused 0 (delta 0) 

Receiving objects: 100% (1167/1167), 81.84 KiB | 68.00 KiB/s, done. 

Resolving deltas: 100% (342/342), done. 

Checking connectivityhttp://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/14950/OEBPS/Text/... done. 


此 时 ,运行 “cd tbc-ticket-dispenser-java" 命令， 进入 刚刚 创建 的 目录 。 运 行 “git branch” 命令 显示 本 地 的 分 支 ， 应 该 只 能 看 到 master 分 支 。 


6) 将 exercise 分 支 从 网 上 复制 到 本 地 。 


接着 运行 “git branch -a” 命 令 显示 所 有 的 分 支 ， 如 下 所 示 : 


* master 
remotes/origin/HEAD -> origin/master 
remotes/origin/bjdp-18-jd 
remotes/origin/exercise 
remotes/origin/extract-interface 
remotes/origin/master 
remotes/origin/subclass-and-override-method 
remotes/origin/using-mockito 
remotes/origin/using-mockito-error-fixing-oriented 


此 时 可 以 看 到 remotes/origin/exercise 分 支 是 红色 的 ， 表 示 它 还 在 网 上 ， 没 有 被 复制 到 本 地 。 


运行 下 面 的 命令 ， 将 exercise 分 支 从 网 上 复制 到 本 地 ， 并 将 当前 分 支 切换 为 该 分 支 。 


git checkout -b exercise origin/exercise 


如 果 命令 运行 成 功 ， 会 有 类 似 下 面 的 输出 : 


Branch exercise set up to track remote branch exercise from origin. 
Switched to a new branch 'exercise' 


此 时 运行 “git branch" 命令， 会 有 下 面 的 输出 : 


$ git branch 
* exercise 
master 


这 里 exercise 左 边 有 一 个 星 号 ， 表 示 它 是 当前 的 分 支 。 


7) 下 载 B] 并 安装 Intellj IDEA 集 成 开发 环境 Community 版 (idealC-13.1.4b) 。 


在 Terminal 命 令 行 窗口 中 ， 用 管理 员 的 权限 将 下 载 下 来 的 安装 文件 idealC-13.1.4b.tar.gz 复 制 到 /opt 目 录 下 。 然 后 运行 “sudo tar xvzf idealC-13.1.4b.tar.gz” 命 令 将 该 文件 解压 到 该 目录 下 。 


需要 配置 一 下 环境 变量 才能 在 命令 行 中 运行 IDEA。 


打开 文件 ~/.bashrc， 在 前 面 所 添加 的 M3_HOME 一 行 下 面 ,添加 下 面 一 行 : 


IDEA_HOME=/opt/idea-IC-135.1230; export IDEA HOME 


再 修改 PATH 的 那 行 ， 将 $IDEA_HOME/bin 添 加 进去 : 


PATH=$JAVA_HOME/bin:$M3_HOME/bin:$IDEA_HOME/bin:$PATH; export PATH 


新 打开 一 个 命令 行 窗口 ， 运 行 “idea.sh & ”命令 打开 IDEA， 在 Open 窗 口中 打开 下 面 的 pom.xml 文 件 。 


/ home / ben / katas / tbc-ticket-dispenser-java / td/ pom.xml 


此 时 ， 在 IDEA 底 部 的 状态 条 中 会 显示 “Downloading plugins for tdhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/14950/OEBPS/VText/…”,， 表 示 IDEA 正 在 下 载 插件 。 待 其 消失 后 ， 表 示 IDEA 已 经 安装 好 了 。 


8) 用 IDEA 运 行 exercise 分 支 中 的 测试 类 。 


将 光标 定位 到 左上 部 的 Project 窗 口中 文件 夹 td/src/test/java/kata.td 下 的 TicketDispenserTest 类 ， 然 后 按 快捷 键 Ctrl+ Shift+F10 来 运行 这 个 测试 类 。 


此 时 会 显示 一 个 对 话 框 ， 显 示 如 下 错误 : 


Error: Cannot start compiler: the SDK is not specified for module "td". Specify 
the SDK at Project Structure dialog. 


这 个 错误 表示 JDK 还 未 在 IDEA 中 配置 好 。 单 击 该 对 话 框 中 的 OK 按钮 后 ， 就 会 出 现 Project Structure 对 话 框 。 其 中 Module SDK: 右边 显示 <No Project SDK> ， 表 示 JDK 未 配 好 。 单 
击 “Newhttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14950/OEBPS/Text/...” 按 钮 ， 出 现 Set up Module SDK 下 拉 菜 单 。 从 中 选择 JDK。 再 
选择 JDK 的 Home Directory 为 /opt/jdk1.8.0_05。 单 击 OK。 当 出 现 “Set up created SDK on project? ”时 ， 选 择 Yes。 然 后 单 击 OK 按钮 。 


然后 再 次 将 光标 定位 到 左上 部 的 Project 窗 口中 td/src/test/java/kata.td 文 件 夹 下 的 TicketDispenserTest 类 ， 然 后 按 快捷 键 Ctrl+ Shift+F10， 来 运行 这 个 测试 类 。 


此 时 IDEA 底 部 的 状态 条 会 显示 一 个 旋转 的 光标 ， 表 示 正 在 编译 运行 该 测试 类 。 等 运行 完毕 后 ， 在 中 下 方 会 出 现 测试 运 行 成 功 的 绿 条 。 现 在 就 可 以 在 IDEA 里 的 这 个 编程 操练 题目 的 原 题 上 进行 编程 了 。 


9) 根据 代码 提交 的 Commit Message (CM) 来 使 用 Git 阅 读 subclass-and-override-method 分 支 中 的 代码 。 


下 面 来 说 明 如 何 根据 本 书 每 段 示例 代码 前 所 标 出 的 CM 来 使 用 Git 阅 读 代码 。 比 如 现在 想 将 代码 恢复 到 书 中 所 标 出 的 CM 的 状态 ， 即 CM : Added TODO: Depending on a static method violates the 


Dependency Inversion Principle and Open-Closed Principle。 


先 运 行 下 面 的 命令 将 subclass-and-override-method 分 支 从 网 上 复制 到 本 地 ， 并 将 其 设置 为 当前 分 支 。 


git checkout -b subclass-and-override-method origin/subclass-and-override-method 


HUT “git branch” 命 令 ， 应 该 可 以 看 到 下 面 的 输出 : 


exercise 
master 
* subclass-and-override-method 


此 时 可 以 运行 “git log” 命 令 来 查看 以 往 提交 的 所 有 CM。 再 运行 “git log> git-log-subclass-and-override-method.txt” 命 令 ， 将 以 往 所 有 的 CM 提交 记录 都 保存 到 一 个 TXT 文 件 中 。 


一 个 文本 编辑 器 打开 这 个 TXT 文 件 ， 查 找 “CM: Added TODO: Depending on a static method violates the Dependency Inversion Principle and Open-Closed Principle.”， 找 到 该 字符 串 
所 在 行 上 方 的 一 长 串 字母 数字 组 成 的 SHA1 值 : da169b7dbb5ce15ebe5c31a91a5b3403b6b5b445。 将 该 值 复制 下 来 。 


然后 运行 命令 “git reset --hard da169b7dbb5ce15ebe5c31a91a5b3403b6b5b445”。 此 时 能 看 到 类 似 下 面 这 样 的 输出 : 


HEAD is now at dal69b7 Added TODO: Depending on a static method violates the 
Dependency Inversion Principle and Open-Closed Principle. 


最 后 运行 “gitk & ”命令 ， 能 够 看 到 一 个 图 形 化 的 Git 工 具 。 从 中 能 够 直观 地 看 到 本 次 提交 下 代码 的 变化 。 


切换 到 IDEA， 能 看 到 其 中 的 代码 也 相应 地 发 生 了 变化 ， 反 应 出 当前 这 个 CM 的 代码 状态 。 


[JDK 8 下 载 地 址 : http://www.oracle.com/technetwork/es/java/javase /downloads/index.html o 
[2] Git 下 载 指 南 : http://www.git-scm.com/download/linux。 
[B] IntelliJ IDEA 下 载 地 址 : http://www.jetbrains.com/idea/download/. 


